@him0/freee-mcp 0.6.1 → 0.6.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (41) hide show
  1. package/bin/cli.js +58 -44
  2. package/package.json +5 -23
  3. package/README.md +0 -207
  4. package/dist/.keep +0 -0
  5. package/dist/api/client.d.ts +0 -10
  6. package/dist/api/client.test.d.ts +0 -1
  7. package/dist/auth/oauth.d.ts +0 -7
  8. package/dist/auth/oauth.test.d.ts +0 -1
  9. package/dist/auth/server.d.ts +0 -34
  10. package/dist/auth/tokens.d.ts +0 -33
  11. package/dist/auth/tokens.test.d.ts +0 -1
  12. package/dist/cli.d.ts +0 -1
  13. package/dist/config/companies.d.ts +0 -116
  14. package/dist/config/companies.test.d.ts +0 -1
  15. package/dist/config/mcp-config.d.ts +0 -34
  16. package/dist/config/mcp-config.test.d.ts +0 -1
  17. package/dist/config.d.ts +0 -32
  18. package/dist/config.test.d.ts +0 -1
  19. package/dist/constants.d.ts +0 -33
  20. package/dist/e2e/auth-flow.e2e.test.d.ts +0 -5
  21. package/dist/e2e/client-mode.e2e.test.d.ts +0 -5
  22. package/dist/e2e/configure.e2e.test.d.ts +0 -5
  23. package/dist/e2e/fixtures/api-responses.d.ts +0 -132
  24. package/dist/e2e/mock-api.d.ts +0 -34
  25. package/dist/index.cjs +0 -78
  26. package/dist/index.d.ts +0 -1
  27. package/dist/index.esm.js +0 -78
  28. package/dist/index.test.d.ts +0 -1
  29. package/dist/mcp/handlers.d.ts +0 -1
  30. package/dist/mcp/handlers.test.d.ts +0 -1
  31. package/dist/mcp/tools.d.ts +0 -2
  32. package/dist/mcp/tools.test.d.ts +0 -1
  33. package/dist/openapi/client-mode.d.ts +0 -5
  34. package/dist/openapi/minimal-types.d.ts +0 -929
  35. package/dist/openapi/schema-loader.d.ts +0 -28
  36. package/dist/openapi/schema-loader.test.d.ts +0 -1
  37. package/dist/openapi/schema.d.ts +0 -5
  38. package/dist/openapi/schema.test.d.ts +0 -1
  39. package/dist/test-utils/setup.d.ts +0 -5
  40. package/dist/test-utils/temp-dir.d.ts +0 -32
  41. package/dist/utils/error.d.ts +0 -32
package/bin/cli.js CHANGED
@@ -1,80 +1,94 @@
1
1
  #! /usr/bin/env node
2
2
 
3
- var ot=Object.defineProperty;var se=(t,e)=>()=>(t&&(e=t(t=0)),e);var Te=(t,e)=>{for(var n in e)ot(t,n,{get:e[n],enumerable:!0})};import Ie from"path";import it from"os";function b(){return process.env.XDG_CONFIG_HOME?Ie.join(process.env.XDG_CONFIG_HOME,Se):Ie.join(it.homedir(),".config",Se)}var Se,M,G,K,W,F=se(()=>{"use strict";Se="freee-mcp";M=54321,G=300*1e3,K=384,W="https://api.freee.co.jp"});var Me={};Te(Me,{CompanyConfigSchema:()=>Re,FullConfigSchema:()=>$e,getCompanyInfo:()=>D,getCurrentCompanyId:()=>A,getDownloadDir:()=>ue,loadFullConfig:()=>P,saveFullConfig:()=>T,setCurrentCompany:()=>pe});import ce from"fs/promises";import xe from"path";import at from"os";import{z as u}from"zod";function le(){return xe.join(b(),"config.json")}async function st(){let t=xe.dirname(le());await ce.mkdir(t,{recursive:!0})}function ct(t){return t!=null&&typeof t=="object"&&"defaultCompanyId"in t&&"currentCompanyId"in t&&"companies"in t&&!("clientId"in t)}function lt(t){return console.error("\u{1F4E6} \u53E4\u3044\u8A2D\u5B9A\u5F62\u5F0F\u3092\u691C\u51FA\u3057\u307E\u3057\u305F\u3002\u65B0\u3057\u3044\u5F62\u5F0F\u306B\u79FB\u884C\u3057\u307E\u3059..."),{clientId:void 0,clientSecret:void 0,callbackPort:void 0,defaultCompanyId:t.defaultCompanyId,currentCompanyId:t.currentCompanyId,companies:t.companies}}async function P(){let t=le();try{let e=await ce.readFile(t,"utf8"),n=JSON.parse(e);if(ct(n)){let o=lt(n);return await T(o),o}let r=$e.safeParse(n);if(!r.success)throw new Error(`Invalid config file: ${r.error.message}`);return r.data}catch(e){if(e.code==="ENOENT"){let n={clientId:void 0,clientSecret:void 0,callbackPort:void 0,defaultCompanyId:"0",currentCompanyId:"0",companies:{}};return await T(n),n}throw e}}async function T(t){await st();let e=le();await ce.writeFile(e,JSON.stringify(t,null,2),{mode:K})}async function A(){return(await P()).currentCompanyId}async function pe(t,e,n){let r=await P();r.companies[t]?(e||n)&&(e&&(r.companies[t].name=e),n&&(r.companies[t].description=n)):r.companies[t]={id:t,name:e||`Company ${t}`,description:n||void 0,addedAt:Date.now()},r.companies[t].lastUsed=Date.now(),r.currentCompanyId=t,await T(r)}async function D(t){return(await P()).companies[t]||null}async function ue(){return(await P()).downloadDir||at.tmpdir()}var Re,$e,I=se(()=>{"use strict";F();Re=u.object({id:u.string(),name:u.string().optional(),description:u.string().optional(),addedAt:u.number(),lastUsed:u.number().optional()}),$e=u.object({clientId:u.string().optional(),clientSecret:u.string().optional(),callbackPort:u.number().optional(),defaultCompanyId:u.string(),currentCompanyId:u.string(),companies:u.record(u.string(),Re),downloadDir:u.string().optional()})});var Fe={};Te(Fe,{getConfig:()=>d,loadConfig:()=>fe});function pt(){return!!(process.env.FREEE_CLIENT_ID||process.env.FREEE_CLIENT_SECRET)}async function fe(){if(S)return S;let t=await P(),e,n,r;if(pt())console.error("Warning: \u74B0\u5883\u5909\u6570\u3067\u306E\u8A8D\u8A3C\u60C5\u5831\u8A2D\u5B9A\u306F\u975E\u63A8\u5968\u3067\u3059\u3002"),console.error(" `freee-mcp configure` \u3092\u5B9F\u884C\u3057\u3066\u8A2D\u5B9A\u30D5\u30A1\u30A4\u30EB\u306B\u79FB\u884C\u3057\u3066\u304F\u3060\u3055\u3044\u3002"),console.error(` \u74B0\u5883\u5909\u6570\u8A2D\u5B9A\u306F\u5C06\u6765\u306E\u30D0\u30FC\u30B8\u30E7\u30F3\u3067\u524A\u9664\u3055\u308C\u308B\u4E88\u5B9A\u3067\u3059\u3002
4
- `),e=process.env.FREEE_CLIENT_ID||"",n=process.env.FREEE_CLIENT_SECRET||"",r=process.env.FREEE_CALLBACK_PORT?parseInt(process.env.FREEE_CALLBACK_PORT,10):M;else{if(!t.clientId||!t.clientSecret)throw new Error("\u8A8D\u8A3C\u60C5\u5831\u304C\u8A2D\u5B9A\u3055\u308C\u3066\u3044\u307E\u305B\u3093\u3002\n`freee-mcp configure` \u3092\u5B9F\u884C\u3057\u3066\u30BB\u30C3\u30C8\u30A2\u30C3\u30D7\u3057\u3066\u304F\u3060\u3055\u3044\u3002");e=t.clientId,n=t.clientSecret,r=t.callbackPort||M}return S={freee:{clientId:e,clientSecret:n,companyId:"0",apiUrl:W},oauth:{callbackPort:r,redirectUri:`http://127.0.0.1:${r}/callback`,authorizationEndpoint:"https://accounts.secure.freee.co.jp/public_api/authorize",tokenEndpoint:"https://accounts.secure.freee.co.jp/public_api/token",scope:"read write"},server:{name:"freee",version:"1.0.0"},auth:{timeoutMs:G}},S}function d(){if(!S)throw new Error("Config not loaded. Call loadConfig() first in async context.");return S}var S,k=se(()=>{"use strict";I();F();S=null});k();import{McpServer as Rt}from"@modelcontextprotocol/sdk/server/mcp.js";import{StdioServerTransport as $t}from"@modelcontextprotocol/sdk/server/stdio.js";k();import gt from"http";import{URL as ht}from"url";import yt from"net";k();import Ue from"crypto";k();F();import _ from"fs/promises";import O from"path";import{z as x}from"zod";async function w(t){return t.json().catch(()=>({}))}function l(t){return{content:[{type:"text",text:t}]}}function C(t){return t instanceof Error?t.message:String(t)}var De=x.object({access_token:x.string(),refresh_token:x.string(),expires_at:x.number(),token_type:x.string(),scope:x.string()});function me(){return O.join(b(),"tokens.json")}async function X(t){let e=me(),n=O.dirname(e);try{console.error(`[info] Creating directory: ${n}`),await _.mkdir(n,{recursive:!0}),console.error(`[info] Writing tokens to: ${e}`),await _.writeFile(e,JSON.stringify(t,null,2),{mode:K}),console.error("[info] Tokens saved successfully")}catch(r){throw console.error("[error] Failed to save tokens:",r),r}}async function de(){let t=me();try{let e=await _.readFile(t,"utf8"),n=JSON.parse(e),r=De.safeParse(n);return r.success?r.data:(console.error("[error] Invalid token file:",r.error.message),null)}catch(e){if(e.code==="ENOENT"){let n=await ft();return n||null}throw console.error("[error] Failed to load tokens:",e),e}}function ut(t){return Date.now()<t.expires_at}async function ft(){let t=b();try{let n=(await _.readdir(t)).filter(r=>r.startsWith("tokens-")&&r.endsWith(".json"));if(n.length>0){let r=O.join(t,n[0]),o=await _.readFile(r,"utf8"),a=JSON.parse(o),i=De.safeParse(a);if(!i.success)return console.error("[error] Invalid legacy token file:",i.error.message),null;let s=i.data;return await X(s),await Promise.all(n.map(p=>_.unlink(O.join(t,p)).catch(m=>{console.error(`[warn] Failed to clean up legacy token file ${p}:`,m)}))),console.error("[info] Migrated legacy company-specific tokens to user-based tokens"),s}}catch(e){console.error("[warn] Error during legacy token migration attempt:",e)}return null}async function mt(t){let e=d(),n=await fetch(e.oauth.tokenEndpoint,{method:"POST",headers:{"Content-Type":"application/x-www-form-urlencoded"},body:new URLSearchParams({grant_type:"refresh_token",refresh_token:t,client_id:e.freee.clientId,client_secret:e.freee.clientSecret})});if(!n.ok){let a=await w(n);throw new Error(`Token refresh failed: ${n.status} ${JSON.stringify(a)}`)}let r=await n.json(),o={access_token:r.access_token,refresh_token:r.refresh_token||t,expires_at:Date.now()+r.expires_in*1e3,token_type:r.token_type||"Bearer",scope:r.scope||e.oauth.scope};return await X(o),o}async function Oe(){let t=me();try{await _.unlink(t),console.error("[info] Tokens cleared successfully")}catch(e){if(e.code==="ENOENT"){console.error("[info] No tokens to clear (file does not exist)");return}throw console.error("[error] Failed to clear tokens:",e),e}await dt()}async function dt(){let t=b();try{let n=(await _.readdir(t)).filter(r=>r.startsWith("tokens-")&&r.endsWith(".json"));await Promise.all(n.map(r=>_.unlink(O.join(t,r)).catch(o=>{console.error(`[warn] Failed to clear legacy token file ${r}:`,o)}))),n.length>0&&console.error("[info] Cleared legacy company-specific token files")}catch(e){console.error("[warn] Error during legacy token cleanup:",e)}}async function je(){let t=await de();if(!t)return null;if(ut(t))return t.access_token;try{return(await mt(t.refresh_token)).access_token}catch(e){return console.error("[warn] Failed to refresh token:",e),null}}function Le(){let t=Ue.randomBytes(32).toString("base64url"),e=Ue.createHash("sha256").update(t).digest("base64url");return{codeVerifier:t,codeChallenge:e}}function Q(t,e,n){let r=d(),o=new URLSearchParams({response_type:"code",client_id:r.freee.clientId,redirect_uri:n,scope:r.oauth.scope,state:e,code_challenge:t,code_challenge_method:"S256"});return`${r.oauth.authorizationEndpoint}?${o.toString()}`}async function Y(t,e,n){let r=d(),o=await fetch(r.oauth.tokenEndpoint,{method:"POST",headers:{"Content-Type":"application/x-www-form-urlencoded"},body:new URLSearchParams({grant_type:"authorization_code",client_id:r.freee.clientId,client_secret:r.freee.clientSecret,code:t,redirect_uri:n,code_verifier:e})});if(!o.ok){let s=await w(o);throw new Error(`Token exchange failed: ${o.status} ${JSON.stringify(s)}`)}let a=await o.json(),i={access_token:a.access_token,refresh_token:a.refresh_token,expires_at:Date.now()+a.expires_in*1e3,token_type:a.token_type||"Bearer",scope:a.scope||r.oauth.scope};return await X(i),i}var ge=class{pendingAuthentications=new Map;cliAuthHandlers=new Map;registerAuthentication(e,n){console.error(`Registering authentication request with state: ${e.substring(0,10)}...`),console.error(`Code verifier: ${n.substring(0,10)}...`);let r=setTimeout(()=>{this.pendingAuthentications.delete(e),console.error(`Authentication timeout for state: ${e.substring(0,10)}...`)},d().auth.timeoutMs);this.pendingAuthentications.set(e,{codeVerifier:n,resolve:o=>{console.error("Authentication completed successfully!")},reject:o=>{console.error("Authentication failed:",o)},timeout:r}),console.error(`Registration complete. Total pending: ${this.pendingAuthentications.size}`)}getPendingAuthentication(e){return this.pendingAuthentications.get(e)}removePendingAuthentication(e){let n=this.pendingAuthentications.get(e);n&&(clearTimeout(n.timeout),this.pendingAuthentications.delete(e))}clearAllPending(){for(let[e,n]of this.pendingAuthentications)clearTimeout(n.timeout),n.reject(new Error("Server shutdown"));this.pendingAuthentications.clear()}get pendingCount(){return this.pendingAuthentications.size}registerCliAuthHandler(e,n){this.cliAuthHandlers.set(e,n)}getCliAuthHandler(e){return this.cliAuthHandlers.get(e)}removeCliAuthHandler(e){this.cliAuthHandlers.delete(e)}},he=class{server=null;port=null;authManager;constructor(e){this.authManager=e}getRedirectUri(){if(this.port===null)throw new Error("Callback server not started. Call start() first.");return`http://127.0.0.1:${this.port}/callback`}getPort(){return this.port}isRunning(){return this.server!==null}async start(){if(this.server)return;let e=d().oauth.callbackPort,n=await this.findAvailablePort(e);return this.port=n,n!==e&&console.error(`Warning: Port ${e} is in use. Using fallback port ${n} for OAuth callback server.`),new Promise((r,o)=>{this.server=gt.createServer((a,i)=>{console.error(`Callback request: ${a.method} ${a.url}`);let s=new ht(a.url,`http://127.0.0.1:${n}`);s.pathname==="/callback"?this.handleCallback(s,i):s.pathname==="/"?(i.writeHead(200,{"Content-Type":"text/html; charset=utf-8"}),i.end("<h1>freee MCP OAuth Server</h1><p>\u30B3\u30FC\u30EB\u30D0\u30C3\u30AF\u30B5\u30FC\u30D0\u30FC\u304C\u7A3C\u50CD\u4E2D\u3067\u3059\u3002</p>")):(i.writeHead(404,{"Content-Type":"text/html; charset=utf-8"}),i.end("<h1>404 Not Found</h1><p>\u3053\u306E\u30D1\u30B9\u306F\u5B58\u5728\u3057\u307E\u305B\u3093\u3002</p>"))}),this.server.on("error",a=>{console.error("Callback server error:",a),o(a)}),this.server.listen(n,"127.0.0.1",()=>{console.error(`OAuth callback server listening on http://127.0.0.1:${n}`),r()})})}stop(){this.server&&(this.authManager.clearAllPending(),this.server.close(()=>{console.error("OAuth callback server stopped")}),this.server=null,this.port=null)}async checkPortAvailable(e){return new Promise(n=>{let r=yt.createServer();r.listen(e,"127.0.0.1",()=>{r.close(()=>{n(!0)})}),r.on("error",()=>{n(!1)})})}async findAvailablePort(e,n=50){for(let r=e;r<e+n;r++)if(await this.checkPortAvailable(r))return r;throw new Error(`No available port found after checking ${n} ports starting from ${e}`)}handleCallback(e,n){let r=e.searchParams.get("code"),o=e.searchParams.get("state"),a=e.searchParams.get("error"),i=e.searchParams.get("error_description");console.error(`Callback received - URL: ${e.toString()}`),console.error("Callback parameters:",{code:r?`${r.substring(0,10)}...`:null,state:o?`${o.substring(0,10)}...`:null,error:a,errorDescription:i}),console.error(`Pending authentications count: ${this.authManager.pendingCount}`);let s=o?this.authManager.getCliAuthHandler(o):void 0;if(a){let m=i||a;if(console.error(`OAuth error: ${a} - ${i}`),n.writeHead(400,{"Content-Type":"text/html; charset=utf-8"}),n.end(`<h1>\u8A8D\u8A3C\u30A8\u30E9\u30FC</h1><p>\u8A8D\u8A3C\u306B\u5931\u6557\u3057\u307E\u3057\u305F: ${m}</p>`),s)s.reject(new Error(`OAuth error: ${a} - ${i}`));else if(o){let v=this.authManager.getPendingAuthentication(o);v&&(clearTimeout(v.timeout),v.reject(new Error(`OAuth error: ${a} - ${i}`)),this.authManager.removePendingAuthentication(o))}return}if(!r||!o){console.error("Missing code or state"),n.writeHead(400,{"Content-Type":"text/html; charset=utf-8"}),n.end("<h1>\u8A8D\u8A3C\u30A8\u30E9\u30FC</h1><p>\u8A8D\u8A3C\u30B3\u30FC\u30C9\u307E\u305F\u306F\u72B6\u614B\u30D1\u30E9\u30E1\u30FC\u30BF\u304C\u4E0D\u8DB3\u3057\u3066\u3044\u307E\u3059\u3002</p>");return}if(s){console.error("Valid CLI callback received"),n.writeHead(200,{"Content-Type":"text/html; charset=utf-8"}),n.end("<h1>\u8A8D\u8A3C\u5B8C\u4E86</h1><p>\u8A8D\u8A3C\u304C\u5B8C\u4E86\u3057\u307E\u3057\u305F\u3002\u3053\u306E\u30DA\u30FC\u30B8\u3092\u9589\u3058\u3066\u30BF\u30FC\u30DF\u30CA\u30EB\u306B\u623B\u3063\u3066\u304F\u3060\u3055\u3044\u3002</p>"),s.resolve(r);return}let p=this.authManager.getPendingAuthentication(o);if(!p){console.error(`Unknown state: ${o}`),n.writeHead(400,{"Content-Type":"text/html; charset=utf-8"}),n.end("<h1>\u8A8D\u8A3C\u30A8\u30E9\u30FC</h1><p>\u4E0D\u660E\u306A\u8A8D\u8A3C\u72B6\u614B\u3067\u3059\u3002\u8A8D\u8A3C\u3092\u518D\u958B\u3057\u3066\u304F\u3060\u3055\u3044\u3002</p>");return}console.error("Valid callback received, exchanging code for tokens..."),n.writeHead(200,{"Content-Type":"text/html; charset=utf-8"}),n.end("<h1>\u8A8D\u8A3C\u5B8C\u4E86</h1><p>\u8A8D\u8A3C\u304C\u5B8C\u4E86\u3057\u307E\u3057\u305F\u3002\u3053\u306E\u30DA\u30FC\u30B8\u3092\u9589\u3058\u3066\u304F\u3060\u3055\u3044\u3002</p>"),this.authManager.removePendingAuthentication(o),Y(r,p.codeVerifier,this.getRedirectUri()).then(m=>{console.error("Token exchange successful!"),p.resolve(m)}).catch(m=>{console.error("Token exchange failed:",m),p.reject(m)})}},ye=new ge,Ce=new he(ye);function j(){return Ce.getRedirectUri()}async function Z(){return Ce.start()}function Ne(t,e){ye.registerAuthentication(t,e)}function U(){Ce.stop()}function Be(){return ye}k();import Et from"crypto";import{z as E}from"zod";k();I();import Ct from"fs/promises";import wt from"path";function _t(t){return["application/pdf","application/octet-stream","image/"].some(n=>t.includes(n))}function kt(t){let e={"application/pdf":".pdf","image/png":".png","image/jpeg":".jpg","image/gif":".gif","image/webp":".webp","text/csv":".csv"};for(let[n,r]of Object.entries(e))if(t.includes(n))return r;return t.includes("image/"),".bin"}async function L(t,e,n,r,o){let a=o||d().freee.apiUrl,i=await A(),s=await je();if(!s)throw new Error(`\u8A8D\u8A3C\u304C\u5FC5\u8981\u3067\u3059\u3002freee_authenticate \u30C4\u30FC\u30EB\u3092\u4F7F\u7528\u3057\u3066\u8A8D\u8A3C\u3092\u884C\u3063\u3066\u304F\u3060\u3055\u3044\u3002
3
+ var At=Object.defineProperty;var le=(t,e)=>()=>(t&&(e=t(t=0)),e);var $e=(t,e)=>{for(var r in e)At(t,r,{get:e[r],enumerable:!0})};import Me from"path";import Tt from"os";function A(){return process.env.XDG_CONFIG_HOME?Me.join(process.env.XDG_CONFIG_HOME,Fe):Me.join(Tt.homedir(),".config",Fe)}var Fe,j,R,W,X,Pt,Oe,w=le(()=>{"use strict";Fe="freee-mcp";j=54321,R=300*1e3,W=384,X="https://api.freee.co.jp",Pt="0.6.3",Oe=`freee-mcp/${Pt} (MCP Server; +https://github.com/him0/freee-mcp)`});var Ue={};$e(Ue,{CompanyConfigSchema:()=>je,FullConfigSchema:()=>Ne,getCompanyInfo:()=>N,getCurrentCompanyId:()=>b,getDownloadDir:()=>me,loadFullConfig:()=>v,saveFullConfig:()=>$,setCurrentCompany:()=>fe});import pe from"fs/promises";import De from"path";import St from"os";import{z as d}from"zod";function ue(){return De.join(A(),"config.json")}async function vt(){let t=De.dirname(ue());await pe.mkdir(t,{recursive:!0})}function bt(t){return t!=null&&typeof t=="object"&&"defaultCompanyId"in t&&"currentCompanyId"in t&&"companies"in t&&!("clientId"in t)}function It(t){return console.error("\u{1F4E6} \u53E4\u3044\u8A2D\u5B9A\u5F62\u5F0F\u3092\u691C\u51FA\u3057\u307E\u3057\u305F\u3002\u65B0\u3057\u3044\u5F62\u5F0F\u306B\u79FB\u884C\u3057\u307E\u3059..."),{clientId:void 0,clientSecret:void 0,callbackPort:void 0,defaultCompanyId:t.defaultCompanyId,currentCompanyId:t.currentCompanyId,companies:t.companies}}async function v(){let t=ue();try{let e=await pe.readFile(t,"utf8"),r=JSON.parse(e);if(bt(r)){let o=It(r);return await $(o),o}let n=Ne.safeParse(r);if(!n.success)throw new Error(`Invalid config file: ${n.error.message}`);return n.data}catch(e){if(e.code==="ENOENT"){let r={clientId:void 0,clientSecret:void 0,callbackPort:void 0,defaultCompanyId:"0",currentCompanyId:"0",companies:{}};return await $(r),r}throw e}}async function $(t){await vt();let e=ue();await pe.writeFile(e,JSON.stringify(t,null,2),{mode:W})}async function b(){return(await v()).currentCompanyId}async function fe(t,e,r){let n=await v();n.companies[t]?(e||r)&&(e&&(n.companies[t].name=e),r&&(n.companies[t].description=r)):n.companies[t]={id:t,name:e||`Company ${t}`,description:r||void 0,addedAt:Date.now()},n.companies[t].lastUsed=Date.now(),n.currentCompanyId=t,await $(n)}async function N(t){return(await v()).companies[t]||null}async function me(){return(await v()).downloadDir||St.tmpdir()}var je,Ne,M=le(()=>{"use strict";w();je=d.object({id:d.string(),name:d.string().optional(),description:d.string().optional(),addedAt:d.number(),lastUsed:d.number().optional()}),Ne=d.object({clientId:d.string().optional(),clientSecret:d.string().optional(),callbackPort:d.number().optional(),defaultCompanyId:d.string(),currentCompanyId:d.string(),companies:d.record(d.string(),je),downloadDir:d.string().optional()})});var Le={};$e(Le,{getConfig:()=>h,loadConfig:()=>de});function xt(){return!!(process.env.FREEE_CLIENT_ID||process.env.FREEE_CLIENT_SECRET)}async function de(){if(F)return F;let t=await v(),e,r,n;if(xt())console.error("Warning: \u74B0\u5883\u5909\u6570\u3067\u306E\u8A8D\u8A3C\u60C5\u5831\u8A2D\u5B9A\u306F\u975E\u63A8\u5968\u3067\u3059\u3002"),console.error(" `freee-mcp configure` \u3092\u5B9F\u884C\u3057\u3066\u8A2D\u5B9A\u30D5\u30A1\u30A4\u30EB\u306B\u79FB\u884C\u3057\u3066\u304F\u3060\u3055\u3044\u3002"),console.error(` \u74B0\u5883\u5909\u6570\u8A2D\u5B9A\u306F\u5C06\u6765\u306E\u30D0\u30FC\u30B8\u30E7\u30F3\u3067\u524A\u9664\u3055\u308C\u308B\u4E88\u5B9A\u3067\u3059\u3002
4
+ `),e=process.env.FREEE_CLIENT_ID||"",r=process.env.FREEE_CLIENT_SECRET||"",n=process.env.FREEE_CALLBACK_PORT?parseInt(process.env.FREEE_CALLBACK_PORT,10):j;else{if(!t.clientId||!t.clientSecret)throw new Error("\u8A8D\u8A3C\u60C5\u5831\u304C\u8A2D\u5B9A\u3055\u308C\u3066\u3044\u307E\u305B\u3093\u3002\n`freee-mcp configure` \u3092\u5B9F\u884C\u3057\u3066\u30BB\u30C3\u30C8\u30A2\u30C3\u30D7\u3057\u3066\u304F\u3060\u3055\u3044\u3002");e=t.clientId,r=t.clientSecret,n=t.callbackPort||j}return F={freee:{clientId:e,clientSecret:r,companyId:"0",apiUrl:X},oauth:{callbackPort:n,redirectUri:`http://127.0.0.1:${n}/callback`,authorizationEndpoint:"https://accounts.secure.freee.co.jp/public_api/authorize",tokenEndpoint:"https://accounts.secure.freee.co.jp/public_api/token",scope:"read write"},server:{name:"freee",version:"1.0.0"},auth:{timeoutMs:R}},F}function h(){if(!F)throw new Error("Config not loaded. Call loadConfig() first in async context.");return F}var F,T=le(()=>{"use strict";M();w();F=null});T();import{McpServer as Kt}from"@modelcontextprotocol/sdk/server/mcp.js";import{StdioServerTransport as Wt}from"@modelcontextprotocol/sdk/server/stdio.js";T();import Lt from"crypto";import{z as P}from"zod";T();T();w();import Z from"fs/promises";import Ve from"path";import{z as C}from"zod";async function _(t){try{return{success:!0,data:await t.json()}}catch(e){return{success:!1,error:e instanceof Error?e.message:String(e)}}}function l(t){return{content:[{type:"text",text:t}]}}function k(t){return t instanceof Error?t.message:String(t)}function Q(t,e){return{access_token:t.access_token,refresh_token:t.refresh_token||e.refreshToken||"",expires_at:Date.now()+t.expires_in*1e3,token_type:t.token_type||"Bearer",scope:t.scope||e.scope}}w();import Y from"fs/promises";import ge from"path";async function Je(){let t=A();try{return(await Y.readdir(t)).filter(r=>r.startsWith("tokens-")&&r.endsWith(".json"))}catch{return[]}}async function Be(t){let e=A();try{let r=await Je();if(r.length>0){let n=ge.join(e,r[0]),o=await Y.readFile(n,"utf8"),a=JSON.parse(o),i=he.safeParse(a);if(!i.success)return console.error("[error] Invalid legacy token file:",i.error.message),null;let s=i.data;return await t(s),await Promise.all(r.map(p=>Y.unlink(ge.join(e,p)).catch(u=>{console.error(`[warn] Failed to clean up legacy token file ${p}:`,u)}))),console.error("[info] Migrated legacy company-specific tokens to user-based tokens"),s}}catch(r){console.error("[warn] Error during legacy token migration attempt:",r)}return null}async function He(){let t=A();try{let e=await Je();await Promise.all(e.map(r=>Y.unlink(ge.join(t,r)).catch(n=>{console.error(`[warn] Failed to clear legacy token file ${r}:`,n)}))),e.length>0&&console.error("[info] Cleared legacy company-specific token files")}catch(e){console.error("[warn] Error during legacy token cleanup:",e)}}var he=C.object({access_token:C.string(),refresh_token:C.string(),expires_at:C.number(),token_type:C.string(),scope:C.string()}),ye=C.object({access_token:C.string(),refresh_token:C.string().optional(),expires_in:C.number(),token_type:C.string().optional(),scope:C.string().optional()});function Ce(){return Ve.join(A(),"tokens.json")}async function ee(t){let e=Ce(),r=Ve.dirname(e);try{console.error(`[info] Creating directory: ${r}`),await Z.mkdir(r,{recursive:!0}),console.error(`[info] Writing tokens to: ${e}`),await Z.writeFile(e,JSON.stringify(t,null,2),{mode:W}),console.error("[info] Tokens saved successfully")}catch(n){throw console.error("[error] Failed to save tokens:",n),n}}async function we(){let t=Ce();try{let e=await Z.readFile(t,"utf8"),r=JSON.parse(e),n=he.safeParse(r);return n.success?n.data:(console.error("[error] Invalid token file:",n.error.message),null)}catch(e){if(e.code==="ENOENT"){let r=await Be(ee);return r||null}throw console.error("[error] Failed to load tokens:",e),e}}function Rt(t){return Date.now()<t.expires_at}async function $t(t){let e=h(),r=await fetch(e.oauth.tokenEndpoint,{method:"POST",headers:{"Content-Type":"application/x-www-form-urlencoded"},body:new URLSearchParams({grant_type:"refresh_token",refresh_token:t,client_id:e.freee.clientId,client_secret:e.freee.clientSecret})});if(!r.ok){let i=await _(r),s=i.success?JSON.stringify(i.data):`(JSON parse failed: ${i.error})`;throw new Error(`Token refresh failed: ${r.status} ${s}`)}let n=await r.json(),o=ye.safeParse(n);if(!o.success)throw new Error(`Invalid token response format: ${o.error.message}`);let a=Q(o.data,{refreshToken:t,scope:e.oauth.scope});return await ee(a),a}async function ze(){let t=Ce();try{await Z.unlink(t),console.error("[info] Tokens cleared successfully")}catch(e){if(e.code==="ENOENT"){console.error("[info] No tokens to clear (file does not exist)");return}throw console.error("[error] Failed to clear tokens:",e),e}await He()}async function qe(){let t=await we();return t?Rt(t)?t.access_token:(await $t(t.refresh_token)).access_token:null}M();w();import Mt from"fs/promises";import Ft from"path";function Ge(t){return typeof t=="object"&&t!==null&&"type"in t&&t.type==="binary"}function Ot(t){return["application/pdf","application/octet-stream","image/"].some(r=>t.includes(r))}function Dt(t){let e={"application/pdf":".pdf","image/png":".png","image/jpeg":".jpg","image/gif":".gif","image/webp":".webp","text/csv":".csv"};for(let[r,n]of Object.entries(e))if(t.includes(r))return n;return t.includes("image/"),".bin"}async function U(t,e,r,n,o){let a=o||h().freee.apiUrl,i=await b(),s=await qe();if(!s)throw new Error(`\u8A8D\u8A3C\u304C\u5FC5\u8981\u3067\u3059\u3002freee_authenticate \u30C4\u30FC\u30EB\u3092\u4F7F\u7528\u3057\u3066\u8A8D\u8A3C\u3092\u884C\u3063\u3066\u304F\u3060\u3055\u3044\u3002
5
5
  \u73FE\u5728\u306E\u4E8B\u696D\u6240ID: ${i}
6
- \u307E\u305F\u306F\u3001FREEE_CLIENT_ID\u74B0\u5883\u5909\u6570\u304C\u6B63\u3057\u304F\u8A2D\u5B9A\u3055\u308C\u3066\u3044\u308B\u304B\u78BA\u8A8D\u3057\u3066\u304F\u3060\u3055\u3044\u3002`);let p=a.endsWith("/")?a:a+"/",m=e.startsWith("/")?e.slice(1):e,v=new URL(m,p);n&&Object.entries(n).forEach(([g,y])=>{y!==void 0&&v.searchParams.append(g,String(y))});let oe=n?.company_id;if(oe!==void 0&&String(oe)!==String(i))throw new Error(`company_id \u306E\u4E0D\u6574\u5408: \u30EA\u30AF\u30A8\u30B9\u30C8\u306E company_id (${oe}) \u3068\u73FE\u5728\u306E\u4E8B\u696D\u6240 (${i}) \u304C\u7570\u306A\u308A\u307E\u3059\u3002
7
- freee_set_company \u3067\u4E8B\u696D\u6240\u3092\u5207\u308A\u66FF\u3048\u308B\u304B\u3001\u30EA\u30AF\u30A8\u30B9\u30C8\u306E company_id \u3092\u4FEE\u6B63\u3057\u3066\u304F\u3060\u3055\u3044\u3002`);let ie=r?.company_id;if(ie!==void 0&&String(ie)!==String(i))throw new Error(`company_id \u306E\u4E0D\u6574\u5408: \u30EA\u30AF\u30A8\u30B9\u30C8\u30DC\u30C7\u30A3\u306E company_id (${ie}) \u3068\u73FE\u5728\u306E\u4E8B\u696D\u6240 (${i}) \u304C\u7570\u306A\u308A\u307E\u3059\u3002
8
- freee_set_company \u3067\u4E8B\u696D\u6240\u3092\u5207\u308A\u66FF\u3048\u308B\u304B\u3001\u30EA\u30AF\u30A8\u30B9\u30C8\u306E company_id \u3092\u4FEE\u6B63\u3057\u3066\u304F\u3060\u3055\u3044\u3002`);let h=await fetch(v.toString(),{method:t,headers:{Authorization:`Bearer ${s}`,"Content-Type":"application/json"},body:r?JSON.stringify(typeof r=="string"?JSON.parse(r):r):void 0});if(h.status===401||h.status===403){let g=await w(h);throw new Error(`\u8A8D\u8A3C\u30A8\u30E9\u30FC\u304C\u767A\u751F\u3057\u307E\u3057\u305F\u3002freee_authenticate \u30C4\u30FC\u30EB\u3092\u4F7F\u7528\u3057\u3066\u518D\u8A8D\u8A3C\u3092\u884C\u3063\u3066\u304F\u3060\u3055\u3044\u3002
6
+ \u307E\u305F\u306F\u3001FREEE_CLIENT_ID\u74B0\u5883\u5909\u6570\u304C\u6B63\u3057\u304F\u8A2D\u5B9A\u3055\u308C\u3066\u3044\u308B\u304B\u78BA\u8A8D\u3057\u3066\u304F\u3060\u3055\u3044\u3002`);let p=a.endsWith("/")?a:a+"/",u=e.startsWith("/")?e.slice(1):e,x=new URL(u,p);r&&Object.entries(r).forEach(([m,f])=>{f!==void 0&&x.searchParams.append(m,String(f))});let se=r?.company_id;if(se!==void 0&&String(se)!==String(i))throw new Error(`company_id \u306E\u4E0D\u6574\u5408: \u30EA\u30AF\u30A8\u30B9\u30C8\u306E company_id (${se}) \u3068\u73FE\u5728\u306E\u4E8B\u696D\u6240 (${i}) \u304C\u7570\u306A\u308A\u307E\u3059\u3002
7
+ freee_set_company \u3067\u4E8B\u696D\u6240\u3092\u5207\u308A\u66FF\u3048\u308B\u304B\u3001\u30EA\u30AF\u30A8\u30B9\u30C8\u306E company_id \u3092\u4FEE\u6B63\u3057\u3066\u304F\u3060\u3055\u3044\u3002`);let ce=n?.company_id;if(ce!==void 0&&String(ce)!==String(i))throw new Error(`company_id \u306E\u4E0D\u6574\u5408: \u30EA\u30AF\u30A8\u30B9\u30C8\u30DC\u30C7\u30A3\u306E company_id (${ce}) \u3068\u73FE\u5728\u306E\u4E8B\u696D\u6240 (${i}) \u304C\u7570\u306A\u308A\u307E\u3059\u3002
8
+ freee_set_company \u3067\u4E8B\u696D\u6240\u3092\u5207\u308A\u66FF\u3048\u308B\u304B\u3001\u30EA\u30AF\u30A8\u30B9\u30C8\u306E company_id \u3092\u4FEE\u6B63\u3057\u3066\u304F\u3060\u3055\u3044\u3002`);let y=await fetch(x.toString(),{method:t,headers:{Authorization:`Bearer ${s}`,"Content-Type":"application/json","User-Agent":Oe},body:n?JSON.stringify(typeof n=="string"?JSON.parse(n):n):void 0});if(y.status===401){let m=await _(y),f=m.success?JSON.stringify(m.data):`(JSON parse failed: ${m.error})`;throw new Error(`\u8A8D\u8A3C\u30A8\u30E9\u30FC\u304C\u767A\u751F\u3057\u307E\u3057\u305F\u3002freee_authenticate \u30C4\u30FC\u30EB\u3092\u4F7F\u7528\u3057\u3066\u518D\u8A8D\u8A3C\u3092\u884C\u3063\u3066\u304F\u3060\u3055\u3044\u3002
9
9
  \u73FE\u5728\u306E\u4E8B\u696D\u6240ID: ${i}
10
- \u30A8\u30E9\u30FC\u8A73\u7D30: ${h.status} ${JSON.stringify(g)}
10
+ \u30A8\u30E9\u30FC\u8A73\u7D30: ${y.status} ${f}
11
11
 
12
12
  \u78BA\u8A8D\u4E8B\u9805:
13
13
  1. FREEE_CLIENT_ID\u74B0\u5883\u5909\u6570\u304C\u6B63\u3057\u304F\u8A2D\u5B9A\u3055\u308C\u3066\u3044\u308B\u304B
14
14
  2. freee\u5074\u3067\u30A2\u30D7\u30EA\u30B1\u30FC\u30B7\u30E7\u30F3\u8A2D\u5B9A\u304C\u6B63\u3057\u3044\u304B\uFF08\u30EA\u30C0\u30A4\u30EC\u30AF\u30C8URI\u7B49\uFF09
15
15
  3. \u30C8\u30FC\u30AF\u30F3\u306E\u6709\u52B9\u671F\u9650\u304C\u5207\u308C\u3066\u3044\u306A\u3044\u304B
16
- 4. \u4E8B\u696D\u6240ID\u304C\u6B63\u3057\u3044\u304B\uFF08freee_get_current_company \u3067\u78BA\u8A8D\uFF09`)}if(!h.ok){let g=await w(h),y=`API request failed: ${h.status}`;if(g&&g.errors&&Array.isArray(g.errors)){let z=[];for(let $ of g.errors)$.messages&&Array.isArray($.messages)&&z.push(...$.messages);z.length>0&&(y+=`
16
+ 4. \u4E8B\u696D\u6240ID\u304C\u6B63\u3057\u3044\u304B\uFF08freee_get_current_company \u3067\u78BA\u8A8D\uFF09`)}if(y.status===403){let m=await _(y),f=m.success?JSON.stringify(m.data):`(JSON parse failed: ${m.error})`;throw new Error(`\u30A2\u30AF\u30BB\u30B9\u62D2\u5426 (403): ${f}
17
+ \u4E8B\u696D\u6240ID: ${i}
18
+
19
+ \u30EC\u30FC\u30C8\u30EA\u30DF\u30C3\u30C8\u306E\u53EF\u80FD\u6027\u304C\u3042\u308A\u307E\u3059\u3002\u6570\u5206\u5F85\u3063\u3066\u304B\u3089\u518D\u8A66\u884C\u3057\u3066\u304F\u3060\u3055\u3044\u3002
20
+ \u305D\u308C\u3067\u3082\u89E3\u6C7A\u3057\u306A\u3044\u5834\u5408\u306F\u3001\u30A2\u30D7\u30EA\u306E\u6A29\u9650\u8A2D\u5B9A\u3092\u78BA\u8A8D\u3059\u308B\u304B\u3001freee_authenticate \u3067\u518D\u8A8D\u8A3C\u3057\u3066\u304F\u3060\u3055\u3044\u3002`)}if(!y.ok){let m=await _(y),f=`API request failed: ${y.status}`;if(m.success){let S=m.data;if(S&&S.errors&&Array.isArray(S.errors)){let D=[];for(let E of S.errors)E&&typeof E=="object"&&"messages"in E&&Array.isArray(E.messages)&&D.push(...E.messages);D.length>0&&(f+=`
17
21
 
18
22
  \u30A8\u30E9\u30FC\u8A73\u7D30:
19
- ${z.join(`
20
- `)}`,h.status===400&&(y+=`
23
+ ${D.join(`
24
+ `)}`,y.status===400&&(f+=`
25
+
26
+ \u30D2\u30F3\u30C8: \u4E0D\u6B63\u306A\u30EA\u30AF\u30A8\u30B9\u30C8\u30A8\u30E9\u30FC\u304C\u767A\u751F\u3057\u307E\u3057\u305F\u3002`,f+=`
27
+ \u65E2\u5B58\u306E\u30C7\u30FC\u30BF\u3092\u53D6\u5F97\u3057\u3066\u6B63\u3057\u3044\u69CB\u9020\u3092\u78BA\u8A8D\u3059\u308B\u3053\u3068\u3092\u304A\u52E7\u3081\u3057\u307E\u3059\u3002`,f+=`
28
+ \u4F8B: get_items, get_partners, get_account_items \u306A\u3069\u3067\u65E2\u5B58\u30C7\u30FC\u30BF\u306E\u69CB\u9020\u3092\u78BA\u8A8D\u3057\u3066\u304F\u3060\u3055\u3044\u3002`))}S?.errors||(f+=`
29
+
30
+ \u8A73\u7D30: ${JSON.stringify(S)}`)}else f+=`
21
31
 
22
- \u30D2\u30F3\u30C8: \u4E0D\u6B63\u306A\u30EA\u30AF\u30A8\u30B9\u30C8\u30A8\u30E9\u30FC\u304C\u767A\u751F\u3057\u307E\u3057\u305F\u3002`,y+=`
23
- \u65E2\u5B58\u306E\u30C7\u30FC\u30BF\u3092\u53D6\u5F97\u3057\u3066\u6B63\u3057\u3044\u69CB\u9020\u3092\u78BA\u8A8D\u3059\u308B\u3053\u3068\u3092\u304A\u52E7\u3081\u3057\u307E\u3059\u3002`,y+=`
24
- \u4F8B: get_items, get_partners, get_account_items \u306A\u3069\u3067\u65E2\u5B58\u30C7\u30FC\u30BF\u306E\u69CB\u9020\u3092\u78BA\u8A8D\u3057\u3066\u304F\u3060\u3055\u3044\u3002`))}throw g?.errors||(y+=`
32
+ \u8A73\u7D30: (JSON parse failed: ${m.error})`;throw new Error(f)}let K=y.headers.get("content-type")||"";if(Ot(K)){let m=await me(),f=Dt(K),D=`freee_download_${Date.now()}${f}`,E=Ft.join(m,D),Re=await y.arrayBuffer();return await Mt.writeFile(E,Buffer.from(Re)),{type:"binary",filePath:E,mimeType:K,size:Re.byteLength}}let xe=await y.text();try{return JSON.parse(xe)}catch{throw new Error(`Failed to parse API response as JSON. Status: ${y.status}, Content-Type: ${K}, Body preview: ${xe.slice(0,200)}`)}}T();import Ke from"crypto";function We(){let t=Ke.randomBytes(32).toString("base64url"),e=Ke.createHash("sha256").update(t).digest("base64url");return{codeVerifier:t,codeChallenge:e}}function te(t,e,r){let n=h(),o=new URLSearchParams({response_type:"code",client_id:n.freee.clientId,redirect_uri:r,scope:n.oauth.scope,state:e,code_challenge:t,code_challenge_method:"S256"});return`${n.oauth.authorizationEndpoint}?${o.toString()}`}async function re(t,e,r){let n=h(),o=await fetch(n.oauth.tokenEndpoint,{method:"POST",headers:{"Content-Type":"application/x-www-form-urlencoded"},body:new URLSearchParams({grant_type:"authorization_code",client_id:n.freee.clientId,client_secret:n.freee.clientSecret,code:t,redirect_uri:r,code_verifier:e})});if(!o.ok){let p=await _(o),u=p.success?JSON.stringify(p.data):`(JSON parse failed: ${p.error})`;throw new Error(`Token exchange failed: ${o.status} ${u}`)}let a=await o.json(),i=ye.safeParse(a);if(!i.success)throw new Error(`Invalid token response format: ${i.error.message}`);let s=Q(i.data,{scope:n.oauth.scope});return await ee(s),s}T();import jt from"http";import{URL as Nt}from"url";import Ut from"net";var _e=class{pendingAuthentications=new Map;cliAuthHandlers=new Map;registerAuthentication(e,r){console.error(`Registering authentication request with state: ${e.substring(0,10)}...`),console.error(`Code verifier: ${r.substring(0,10)}...`);let n=setTimeout(()=>{this.pendingAuthentications.delete(e),console.error(`Authentication timeout for state: ${e.substring(0,10)}...`)},h().auth.timeoutMs);this.pendingAuthentications.set(e,{codeVerifier:r,resolve:o=>{console.error("Authentication completed successfully!")},reject:o=>{console.error("Authentication failed:",o)},timeout:n}),console.error(`Registration complete. Total pending: ${this.pendingAuthentications.size}`)}getPendingAuthentication(e){return this.pendingAuthentications.get(e)}removePendingAuthentication(e){let r=this.pendingAuthentications.get(e);r&&(clearTimeout(r.timeout),this.pendingAuthentications.delete(e))}clearAllPending(){for(let[e,r]of this.pendingAuthentications)clearTimeout(r.timeout),r.reject(new Error("Server shutdown"));this.pendingAuthentications.clear()}get pendingCount(){return this.pendingAuthentications.size}registerCliAuthHandler(e,r){this.cliAuthHandlers.set(e,r)}getCliAuthHandler(e){return this.cliAuthHandlers.get(e)}removeCliAuthHandler(e){this.cliAuthHandlers.delete(e)}},ke=class{server=null;port=null;authManager;autoStopTimeout=null;constructor(e){this.authManager=e}clearAutoStopTimeout(){this.autoStopTimeout&&(clearTimeout(this.autoStopTimeout),this.autoStopTimeout=null)}scheduleAutoStop(e){this.clearAutoStopTimeout(),this.autoStopTimeout=setTimeout(()=>{console.error("OAuth callback server auto-stopping after timeout"),this.stop()},e)}getRedirectUri(){if(this.port===null)throw new Error("Callback server not started. Call start() first.");return`http://127.0.0.1:${this.port}/callback`}getPort(){return this.port}isRunning(){return this.server!==null}async start(){if(this.server){console.error("OAuth callback server is already running. If authentication is not working, try restarting the MCP server.");return}let e=h().oauth.callbackPort;if(!await this.checkPortAvailable(e)){let n=`http://127.0.0.1:${e}/callback`;throw new Error(`\u30DD\u30FC\u30C8 ${e} \u306F\u65E2\u306B\u4F7F\u7528\u3055\u308C\u3066\u3044\u307E\u3059\u3002
25
33
 
26
- \u8A73\u7D30: ${JSON.stringify(g)}`),new Error(y)}let ae=h.headers.get("content-type")||"";if(_t(ae)){let g=await ue(),y=kt(ae),$=`freee_download_${Date.now()}${y}`,ve=wt.join(g,$),be=await h.arrayBuffer();return await Ct.writeFile(ve,Buffer.from(be)),{type:"binary",filePath:ve,mimeType:ae,size:be.byteLength}}return h.json()}I();function He(t){t.tool("freee_current_user","\u73FE\u5728\u306E\u30E6\u30FC\u30B6\u30FC\u60C5\u5831\u3092\u53D6\u5F97\u3002\u8A73\u7D30\u30AC\u30A4\u30C9\u306Ffreee-mcp skill\u3092\u53C2\u7167\u3002",{},async()=>{try{let e=await A(),n=await D(e);if(!e)return l("\u4F1A\u793EID\u304C\u8A2D\u5B9A\u3055\u308C\u3066\u3044\u307E\u305B\u3093\u3002freee_set_current_company \u3067\u8A2D\u5B9A\u3057\u3066\u304F\u3060\u3055\u3044\u3002");let r=await L("GET","/api/1/users/me");return l(`\u73FE\u5728\u306E\u30E6\u30FC\u30B6\u30FC\u60C5\u5831:
34
+ freee \u30A2\u30D7\u30EA\u306B\u30B3\u30FC\u30EB\u30D0\u30C3\u30AFURL (${n}) \u3092\u767B\u9332\u3057\u3066\u3044\u308B\u5834\u5408\u3001\u30DD\u30FC\u30C8\u3092\u5909\u66F4\u3059\u308B\u3068\u8A8D\u8A3C\u304C\u5931\u6557\u3057\u307E\u3059\u3002
35
+
36
+ \u89E3\u6C7A\u65B9\u6CD5:
37
+ 1. \u30DD\u30FC\u30C8 ${e} \u3092\u4F7F\u7528\u3057\u3066\u3044\u308B\u30D7\u30ED\u30BB\u30B9\u3092\u7D42\u4E86\u3059\u308B
38
+ (\u4F8B: lsof -i :${e} \u3067\u30D7\u30ED\u30BB\u30B9\u3092\u78BA\u8A8D)
39
+ 2. \u307E\u305F\u306F\u3001\u8A2D\u5B9A\u3067\u30DD\u30FC\u30C8\u3092\u5909\u66F4\u3057\u3001freee \u30A2\u30D7\u30EA\u306E\u30B3\u30FC\u30EB\u30D0\u30C3\u30AFURL\u3082\u66F4\u65B0\u3059\u308B
40
+ (freee-mcp configure \u3092\u5B9F\u884C\u3057\u3066\u518D\u8A2D\u5B9A)`)}return this.port=e,new Promise((n,o)=>{this.server=jt.createServer((a,i)=>{console.error(`Callback request: ${a.method} ${a.url}`);let s=new Nt(a.url,`http://127.0.0.1:${e}`);s.pathname==="/callback"?this.handleCallback(s,i):s.pathname==="/"?(i.writeHead(200,{"Content-Type":"text/html; charset=utf-8"}),i.end("<h1>freee MCP OAuth Server</h1><p>\u30B3\u30FC\u30EB\u30D0\u30C3\u30AF\u30B5\u30FC\u30D0\u30FC\u304C\u7A3C\u50CD\u4E2D\u3067\u3059\u3002</p>")):(i.writeHead(404,{"Content-Type":"text/html; charset=utf-8"}),i.end("<h1>404 Not Found</h1><p>\u3053\u306E\u30D1\u30B9\u306F\u5B58\u5728\u3057\u307E\u305B\u3093\u3002</p>"))}),this.server.on("error",a=>{let i=a instanceof Error?a.message:String(a);console.error(`OAuth callback server failed to start: ${i}`),this.server=null,this.port=null,o(new Error(`Failed to start OAuth callback server: ${i}`))}),this.server.listen(e,"127.0.0.1",()=>{console.error(`OAuth callback server listening on http://127.0.0.1:${e}`),n()})})}stop(){this.clearAutoStopTimeout(),this.server&&(this.authManager.clearAllPending(),this.server.close(()=>{console.error("OAuth callback server stopped")}),this.server=null,this.port=null)}async checkPortAvailable(e){return new Promise(r=>{let n=Ut.createServer();n.listen(e,"127.0.0.1",()=>{n.close(()=>{r(!0)})}),n.on("error",()=>{r(!1)})})}handleCallback(e,r){let n=e.searchParams.get("code"),o=e.searchParams.get("state"),a=e.searchParams.get("error"),i=e.searchParams.get("error_description");console.error(`Callback received - URL: ${e.toString()}`),console.error("Callback parameters:",{code:n?`${n.substring(0,10)}...`:null,state:o?`${o.substring(0,10)}...`:null,error:a,errorDescription:i}),console.error(`Pending authentications count: ${this.authManager.pendingCount}`);let s=o?this.authManager.getCliAuthHandler(o):void 0;if(a){let u=i||a;if(console.error(`OAuth error: ${a} - ${i}`),r.writeHead(400,{"Content-Type":"text/html; charset=utf-8"}),r.end(`<h1>\u8A8D\u8A3C\u30A8\u30E9\u30FC</h1><p>\u8A8D\u8A3C\u306B\u5931\u6557\u3057\u307E\u3057\u305F: ${u}</p>`),s)s.reject(new Error(`OAuth error: ${a} - ${i}`));else if(o){let x=this.authManager.getPendingAuthentication(o);x&&(clearTimeout(x.timeout),x.reject(new Error(`OAuth error: ${a} - ${i}`)),this.authManager.removePendingAuthentication(o))}return}if(!n||!o){console.error("Missing code or state"),r.writeHead(400,{"Content-Type":"text/html; charset=utf-8"}),r.end("<h1>\u8A8D\u8A3C\u30A8\u30E9\u30FC</h1><p>\u8A8D\u8A3C\u30B3\u30FC\u30C9\u307E\u305F\u306F\u72B6\u614B\u30D1\u30E9\u30E1\u30FC\u30BF\u304C\u4E0D\u8DB3\u3057\u3066\u3044\u307E\u3059\u3002</p>");return}if(s){console.error("Valid CLI callback received"),r.writeHead(200,{"Content-Type":"text/html; charset=utf-8"}),r.end("<h1>\u8A8D\u8A3C\u5B8C\u4E86</h1><p>\u8A8D\u8A3C\u304C\u5B8C\u4E86\u3057\u307E\u3057\u305F\u3002\u3053\u306E\u30DA\u30FC\u30B8\u3092\u9589\u3058\u3066\u30BF\u30FC\u30DF\u30CA\u30EB\u306B\u623B\u3063\u3066\u304F\u3060\u3055\u3044\u3002</p>"),s.resolve(n);return}let p=this.authManager.getPendingAuthentication(o);if(!p){console.error(`Unknown state: ${o}`),r.writeHead(400,{"Content-Type":"text/html; charset=utf-8"}),r.end("<h1>\u8A8D\u8A3C\u30A8\u30E9\u30FC</h1><p>\u4E0D\u660E\u306A\u8A8D\u8A3C\u72B6\u614B\u3067\u3059\u3002\u8A8D\u8A3C\u3092\u518D\u958B\u3057\u3066\u304F\u3060\u3055\u3044\u3002</p>");return}console.error("Valid callback received, exchanging code for tokens..."),r.writeHead(200,{"Content-Type":"text/html; charset=utf-8"}),r.end("<h1>\u8A8D\u8A3C\u5B8C\u4E86</h1><p>\u8A8D\u8A3C\u304C\u5B8C\u4E86\u3057\u307E\u3057\u305F\u3002\u3053\u306E\u30DA\u30FC\u30B8\u3092\u9589\u3058\u3066\u304F\u3060\u3055\u3044\u3002</p>"),this.authManager.removePendingAuthentication(o),re(n,p.codeVerifier,this.getRedirectUri()).then(u=>{console.error("Token exchange successful!"),p.resolve(u)}).catch(u=>{console.error("Token exchange failed:",u),p.reject(u)})}},Ee=new _e,L=new ke(Ee);function J(){return L.getRedirectUri()}async function Xe(){return L.start()}async function Qe(t){await L.start(),L.scheduleAutoStop(t)}function Ye(t,e){Ee.registerAuthentication(t,e)}function Ze(){L.stop()}function et(){return Ee}M();w();function tt(t){t.tool("freee_current_user","\u73FE\u5728\u306E\u30E6\u30FC\u30B6\u30FC\u60C5\u5831\u3092\u53D6\u5F97\u3002\u8A73\u7D30\u30AC\u30A4\u30C9\u306Ffreee-mcp skill\u3092\u53C2\u7167\u3002",{},async()=>{try{let e=await b(),r=await N(e);if(!e)return l("\u4F1A\u793EID\u304C\u8A2D\u5B9A\u3055\u308C\u3066\u3044\u307E\u305B\u3093\u3002freee_set_current_company \u3067\u8A2D\u5B9A\u3057\u3066\u304F\u3060\u3055\u3044\u3002");let n=await U("GET","/api/1/users/me");return l(`\u73FE\u5728\u306E\u30E6\u30FC\u30B6\u30FC\u60C5\u5831:
27
41
  \u4F1A\u793EID: ${e}
28
- \u4F1A\u793E\u540D: ${n?.name||"Unknown"}
42
+ \u4F1A\u793E\u540D: ${r?.name||"Unknown"}
29
43
  \u30E6\u30FC\u30B6\u30FC\u8A73\u7D30:
30
- ${JSON.stringify(r,null,2)}`)}catch(e){return l(`\u30E6\u30FC\u30B6\u30FC\u60C5\u5831\u306E\u53D6\u5F97\u306B\u5931\u6557: ${C(e)}`)}}),t.tool("freee_authenticate","OAuth\u8A8D\u8A3C\u3092\u958B\u59CB\u3002\u521D\u56DE\u306E\u307F\u5FC5\u8981\u3002",{},async()=>{try{if(!d().freee.clientId)return l(`FREEE_CLIENT_ID\u74B0\u5883\u5909\u6570\u304C\u8A2D\u5B9A\u3055\u308C\u3066\u3044\u307E\u305B\u3093\u3002
44
+ ${JSON.stringify(n,null,2)}`)}catch(e){return l(`\u30E6\u30FC\u30B6\u30FC\u60C5\u5831\u306E\u53D6\u5F97\u306B\u5931\u6557: ${k(e)}`)}}),t.tool("freee_authenticate","OAuth\u8A8D\u8A3C\u3092\u958B\u59CB\u3002\u521D\u56DE\u306E\u307F\u5FC5\u8981\u3002",{},async()=>{try{if(!h().freee.clientId)return l(`FREEE_CLIENT_ID\u74B0\u5883\u5909\u6570\u304C\u8A2D\u5B9A\u3055\u308C\u3066\u3044\u307E\u305B\u3093\u3002
31
45
  OAuth\u8A8D\u8A3C\u3092\u884C\u3046\u306B\u306F\u3001freee developers\u3067\u30A2\u30D7\u30EA\u30B1\u30FC\u30B7\u30E7\u30F3\u3092\u4F5C\u6210\u3057\u3001
32
- \u30AF\u30E9\u30A4\u30A2\u30F3\u30C8ID\u3092\u74B0\u5883\u5909\u6570\u306B\u8A2D\u5B9A\u3057\u3066\u304F\u3060\u3055\u3044\u3002`);if(!d().freee.clientSecret)return l(`FREEE_CLIENT_SECRET\u74B0\u5883\u5909\u6570\u304C\u8A2D\u5B9A\u3055\u308C\u3066\u3044\u307E\u305B\u3093\u3002
46
+ \u30AF\u30E9\u30A4\u30A2\u30F3\u30C8ID\u3092\u74B0\u5883\u5909\u6570\u306B\u8A2D\u5B9A\u3057\u3066\u304F\u3060\u3055\u3044\u3002`);if(!h().freee.clientSecret)return l(`FREEE_CLIENT_SECRET\u74B0\u5883\u5909\u6570\u304C\u8A2D\u5B9A\u3055\u308C\u3066\u3044\u307E\u305B\u3093\u3002
33
47
  OAuth\u8A8D\u8A3C\u3092\u884C\u3046\u306B\u306F\u3001freee developers\u3067\u30A2\u30D7\u30EA\u30B1\u30FC\u30B7\u30E7\u30F3\u3092\u4F5C\u6210\u3057\u3001
34
- \u30AF\u30E9\u30A4\u30A2\u30F3\u30C8\u30B7\u30FC\u30AF\u30EC\u30C3\u30C8\u3092\u74B0\u5883\u5909\u6570\u306B\u8A2D\u5B9A\u3057\u3066\u304F\u3060\u3055\u3044\u3002`);let{codeVerifier:e,codeChallenge:n}=Le(),r=Et.randomBytes(16).toString("hex"),o=Q(n,r,j());return Ne(r,e),console.error(`Authentication URL: ${o}`),l(`\u8A8D\u8A3CURL: ${o}
48
+ \u30AF\u30E9\u30A4\u30A2\u30F3\u30C8\u30B7\u30FC\u30AF\u30EC\u30C3\u30C8\u3092\u74B0\u5883\u5909\u6570\u306B\u8A2D\u5B9A\u3057\u3066\u304F\u3060\u3055\u3044\u3002`);await Qe(R);let{codeVerifier:e,codeChallenge:r}=We(),n=Lt.randomBytes(16).toString("hex"),o=te(r,n,J());return Ye(n,e),console.error(`Authentication URL: ${o}`),l(`\u8A8D\u8A3CURL: ${o}
35
49
 
36
- \u30D6\u30E9\u30A6\u30B6\u3067\u958B\u3044\u3066\u8A8D\u8A3C\u3057\u3066\u304F\u3060\u3055\u3044\u30025\u5206\u3067\u30BF\u30A4\u30E0\u30A2\u30A6\u30C8\u3057\u307E\u3059\u3002`)}catch(e){return l(`\u8A8D\u8A3C\u958B\u59CB\u306B\u5931\u6557: ${C(e)}`)}}),t.tool("freee_auth_status","\u8A8D\u8A3C\u72B6\u614B\u3092\u78BA\u8A8D\u3002",{},async()=>{try{let e=await de();if(!e)return l("\u672A\u8A8D\u8A3C\u3002freee_authenticate \u3067\u8A8D\u8A3C\u3057\u3066\u304F\u3060\u3055\u3044\u3002");let n=Date.now()<e.expires_at,r=new Date(e.expires_at).toLocaleString();return l(`\u8A8D\u8A3C\u72B6\u614B: ${n?"\u6709\u52B9":"\u671F\u9650\u5207\u308C"}
37
- \u6709\u52B9\u671F\u9650: ${r}`+(n?"":`
38
- \u6B21\u56DEAPI\u4F7F\u7528\u6642\u306B\u81EA\u52D5\u66F4\u65B0\u3055\u308C\u307E\u3059\u3002`))}catch(e){return l(`\u8A8D\u8A3C\u72B6\u614B\u306E\u78BA\u8A8D\u306B\u5931\u6557: ${C(e)}`)}}),t.tool("freee_clear_auth","\u8A8D\u8A3C\u60C5\u5831\u3092\u30AF\u30EA\u30A2\u3002",{},async()=>{try{return await Oe(),l("\u8A8D\u8A3C\u60C5\u5831\u3092\u30AF\u30EA\u30A2\u3057\u307E\u3057\u305F\u3002\u518D\u8A8D\u8A3C\u3059\u308B\u306B\u306F freee_authenticate \u3092\u4F7F\u7528\u3002")}catch(e){return l(`\u8A8D\u8A3C\u60C5\u5831\u306E\u30AF\u30EA\u30A2\u306B\u5931\u6557: ${C(e)}`)}}),t.tool("freee_set_current_company","\u4E8B\u696D\u6240\u3092\u8A2D\u5B9A\u30FB\u5207\u308A\u66FF\u3048\u3002",{company_id:E.string().describe("\u4E8B\u696D\u6240ID"),name:E.string().optional().describe("\u4E8B\u696D\u6240\u540D"),description:E.string().optional().describe("\u8AAC\u660E")},async e=>{try{let{company_id:n,name:r,description:o}=e;await pe(n,r,o);let a=await D(n);return l(`\u4E8B\u696D\u6240\u3092\u8A2D\u5B9A: ${a?.name||n}`)}catch(n){return l(`\u4E8B\u696D\u6240\u306E\u8A2D\u5B9A\u306B\u5931\u6557: ${C(n)}`)}}),t.tool("freee_get_current_company","\u73FE\u5728\u306E\u4E8B\u696D\u6240\u60C5\u5831\u3092\u8868\u793A\u3002",{},async()=>{try{let e=await A(),n=await D(e);return n?l(`\u4E8B\u696D\u6240: ${n.name} (ID: ${n.id})`):l(`\u4E8B\u696D\u6240ID: ${e} (\u8A73\u7D30\u60C5\u5831\u306A\u3057)`)}catch(e){return l(`\u4E8B\u696D\u6240\u60C5\u5831\u306E\u53D6\u5F97\u306B\u5931\u6557: ${C(e)}`)}}),t.tool("freee_list_companies","\u4E8B\u696D\u6240\u4E00\u89A7\u3092\u8868\u793A\u3002",{},async()=>{try{let e=E.object({companies:E.array(E.object({id:E.number(),name:E.string()})).optional()}),n=await L("GET","/api/1/companies"),r=e.safeParse(n);if(!r.success)return{content:[{type:"text",text:`API\u30EC\u30B9\u30DD\u30F3\u30B9\u306E\u5F62\u5F0F\u304C\u4E0D\u6B63\u3067\u3059: ${r.error.message}`}]};let o=r.data,a=await A();if(!o?.companies?.length)return l("\u4E8B\u696D\u6240\u60C5\u5831\u3092\u53D6\u5F97\u3067\u304D\u307E\u305B\u3093\u3067\u3057\u305F\u3002");let i=o.companies.map(s=>{let p=s.id===parseInt(a)?" *":"";return`${s.name} (${s.id})${p}`}).join(`
50
+ \u30D6\u30E9\u30A6\u30B6\u3067\u958B\u3044\u3066\u8A8D\u8A3C\u3057\u3066\u304F\u3060\u3055\u3044\u30025\u5206\u3067\u30BF\u30A4\u30E0\u30A2\u30A6\u30C8\u3057\u307E\u3059\u3002`)}catch(e){return l(`\u8A8D\u8A3C\u958B\u59CB\u306B\u5931\u6557: ${k(e)}`)}}),t.tool("freee_auth_status","\u8A8D\u8A3C\u72B6\u614B\u3092\u78BA\u8A8D\u3002",{},async()=>{try{let e=await we();if(!e)return l("\u672A\u8A8D\u8A3C\u3002freee_authenticate \u3067\u8A8D\u8A3C\u3057\u3066\u304F\u3060\u3055\u3044\u3002");let r=Date.now()<e.expires_at,n=new Date(e.expires_at).toLocaleString();return l(`\u8A8D\u8A3C\u72B6\u614B: ${r?"\u6709\u52B9":"\u671F\u9650\u5207\u308C"}
51
+ \u6709\u52B9\u671F\u9650: ${n}`+(r?"":`
52
+ \u6B21\u56DEAPI\u4F7F\u7528\u6642\u306B\u81EA\u52D5\u66F4\u65B0\u3055\u308C\u307E\u3059\u3002`))}catch(e){return l(`\u8A8D\u8A3C\u72B6\u614B\u306E\u78BA\u8A8D\u306B\u5931\u6557: ${k(e)}`)}}),t.tool("freee_clear_auth","\u8A8D\u8A3C\u60C5\u5831\u3092\u30AF\u30EA\u30A2\u3002",{},async()=>{try{return await ze(),l("\u8A8D\u8A3C\u60C5\u5831\u3092\u30AF\u30EA\u30A2\u3057\u307E\u3057\u305F\u3002\u518D\u8A8D\u8A3C\u3059\u308B\u306B\u306F freee_authenticate \u3092\u4F7F\u7528\u3002")}catch(e){return l(`\u8A8D\u8A3C\u60C5\u5831\u306E\u30AF\u30EA\u30A2\u306B\u5931\u6557: ${k(e)}`)}}),t.tool("freee_set_current_company","\u4E8B\u696D\u6240\u3092\u8A2D\u5B9A\u30FB\u5207\u308A\u66FF\u3048\u3002",{company_id:P.string().describe("\u4E8B\u696D\u6240ID"),name:P.string().optional().describe("\u4E8B\u696D\u6240\u540D"),description:P.string().optional().describe("\u8AAC\u660E")},async e=>{try{let{company_id:r,name:n,description:o}=e;await fe(r,n,o);let a=await N(r);return l(`\u4E8B\u696D\u6240\u3092\u8A2D\u5B9A: ${a?.name||r}`)}catch(r){return l(`\u4E8B\u696D\u6240\u306E\u8A2D\u5B9A\u306B\u5931\u6557: ${k(r)}`)}}),t.tool("freee_get_current_company","\u73FE\u5728\u306E\u4E8B\u696D\u6240\u60C5\u5831\u3092\u8868\u793A\u3002",{},async()=>{try{let e=await b(),r=await N(e);return r?l(`\u4E8B\u696D\u6240: ${r.name} (ID: ${r.id})`):l(`\u4E8B\u696D\u6240ID: ${e} (\u8A73\u7D30\u60C5\u5831\u306A\u3057)`)}catch(e){return l(`\u4E8B\u696D\u6240\u60C5\u5831\u306E\u53D6\u5F97\u306B\u5931\u6557: ${k(e)}`)}}),t.tool("freee_list_companies","\u4E8B\u696D\u6240\u4E00\u89A7\u3092\u8868\u793A\u3002",{},async()=>{try{let e=P.object({companies:P.array(P.object({id:P.number(),name:P.string()})).optional()}),r=await U("GET","/api/1/companies"),n=e.safeParse(r);if(!n.success)return{content:[{type:"text",text:`API\u30EC\u30B9\u30DD\u30F3\u30B9\u306E\u5F62\u5F0F\u304C\u4E0D\u6B63\u3067\u3059: ${n.error.message}`}]};let o=n.data,a=await b();if(!o?.companies?.length)return l("\u4E8B\u696D\u6240\u60C5\u5831\u3092\u53D6\u5F97\u3067\u304D\u307E\u305B\u3093\u3067\u3057\u305F\u3002");let i=o.companies.map(s=>{let p=s.id===parseInt(a)?" *":"";return`${s.name} (${s.id})${p}`}).join(`
39
53
  `);return l(`\u4E8B\u696D\u6240\u4E00\u89A7:
40
- ${i}`)}catch(e){return l(`\u4E8B\u696D\u6240\u4E00\u89A7\u306E\u53D6\u5F97\u306B\u5931\u6557: ${C(e)}`)}})}import{z as c}from"zod";import ze from"node:fs";import B from"node:path";import{fileURLToPath as vt}from"node:url";import{z as f}from"zod";var Pt=f.object({name:f.string(),in:f.enum(["path","query"]),required:f.boolean().optional(),description:f.string().optional(),type:f.string()}),N=f.object({summary:f.string().optional(),description:f.string().optional(),parameters:f.array(Pt).optional(),hasJsonBody:f.boolean().optional()}),At=f.object({get:N.optional(),post:N.optional(),put:N.optional(),delete:N.optional(),patch:N.optional()}),Je=f.object({paths:f.record(f.string(),At)});var we=B.dirname(vt(import.meta.url));function bt(){let t=[B.resolve(we,"./openapi/minimal"),B.resolve(we,"../dist/openapi/minimal"),B.resolve(we,"../../openapi/minimal")];for(let e of t)if(ze.existsSync(e))return e;throw new Error(`Could not find minimal schema directory. Searched paths:
54
+ ${i}`)}catch(e){return l(`\u4E8B\u696D\u6240\u4E00\u89A7\u306E\u53D6\u5F97\u306B\u5931\u6557: ${k(e)}`)}})}import{z as c}from"zod";import it from"node:fs";import H from"node:path";import{fileURLToPath as Ht}from"node:url";import{z as g}from"zod";var Jt=g.object({name:g.string(),in:g.enum(["path","query"]),required:g.boolean().optional(),description:g.string().optional(),type:g.string()}),B=g.object({summary:g.string().optional(),description:g.string().optional(),parameters:g.array(Jt).optional(),hasJsonBody:g.boolean().optional()}),Bt=g.object({get:B.optional(),post:B.optional(),put:B.optional(),delete:B.optional(),patch:B.optional()}),rt=g.object({paths:g.record(g.string(),Bt)});var Ae=H.dirname(Ht(import.meta.url));function Vt(){let t=[H.resolve(Ae,"./openapi/minimal"),H.resolve(Ae,"../dist/openapi/minimal"),H.resolve(Ae,"../../openapi/minimal")];for(let e of t)if(it.existsSync(e))return e;throw new Error(`Could not find minimal schema directory. Searched paths:
41
55
  ${t.join(`
42
- `)}`)}var Tt=bt();function It(t){let e=B.join(Tt,t),n=ze.readFileSync(e,"utf-8"),r=JSON.parse(n),o=Je.safeParse(r);if(!o.success)throw new Error(`Invalid schema file ${t}: ${o.error.message}`);return o.data}var ee={accounting:{schemaFile:"accounting.json",baseUrl:"https://api.freee.co.jp",prefix:"accounting",name:"freee\u4F1A\u8A08 API"},hr:{schemaFile:"hr.json",baseUrl:"https://api.freee.co.jp/hr",prefix:"hr",name:"freee\u4EBA\u4E8B\u52B4\u52D9 API"},invoice:{schemaFile:"invoice.json",baseUrl:"https://api.freee.co.jp/iv",prefix:"invoice",name:"freee\u8ACB\u6C42\u66F8 API"},pm:{schemaFile:"pm.json",baseUrl:"https://api.freee.co.jp/pm",prefix:"pm",name:"freee\u5DE5\u6570\u7BA1\u7406 API"},sm:{schemaFile:"sm.json",baseUrl:"https://api.freee.co.jp/sm",prefix:"sm",name:"freee\u8CA9\u58F2 API"}},_e={};function Ve(t){if(!_e[t]){let e=ee[t];_e[t]={schema:It(e.schemaFile),baseUrl:e.baseUrl,prefix:e.prefix,name:e.name}}return _e[t]}var ke=new Proxy({},{get(t,e){if(e in ee)return Ve(e)},ownKeys(){return Object.keys(ee)},getOwnPropertyDescriptor(t,e){if(e in ee)return{enumerable:!0,configurable:!0,value:Ve(e)}}});function qe(t,e,n,r){let o=r.schema.paths;if(e in o){let a=o[e];if(t in a)return{isValid:!0,message:"Valid path and method",operation:a[t],actualPath:e,apiType:n,baseUrl:r.baseUrl}}for(let a of Object.keys(o)){let i=a.replace(/\{[^}]+\}/g,"[^/]+");if(new RegExp(`^${i}$`).test(e)){let p=o[a];if(t in p)return{isValid:!0,message:"Valid path and method",operation:p[t],actualPath:e,apiType:n,baseUrl:r.baseUrl}}}return null}function Ge(t,e,n){let r=t.toLowerCase();if(n!==void 0){let o=ke[n],a=qe(r,e,n,o);return a||{isValid:!1,message:`Path '${e}' not found in ${o.name} schema. Please check the path format or use freee_api_list_paths to see available endpoints.`}}for(let[o,a]of Object.entries(ke)){let i=qe(r,e,o,a);if(i)return i}return{isValid:!1,message:`Path '${e}' not found in any freee API schema. Please check the path format or use freee_api_list_paths to see available endpoints.`}}function Ke(){let t=[];for(let[,e]of Object.entries(ke)){let n=e.schema.paths,r=[];Object.entries(n).forEach(([o,a])=>{let i=Object.keys(a).filter(s=>["get","post","put","delete","patch"].includes(s)).map(s=>s.toUpperCase());i.length>0&&r.push(` ${i.join("|")} ${o}`)}),r.length>0&&t.push(`
56
+ `)}`)}var zt=Vt();function qt(t){let e=H.join(zt,t),r=it.readFileSync(e,"utf-8"),n=JSON.parse(r),o=rt.safeParse(n);if(!o.success)throw new Error(`Invalid schema file ${t}: ${o.error.message}`);return o.data}var ne={accounting:{schemaFile:"accounting.json",baseUrl:"https://api.freee.co.jp",prefix:"accounting",name:"freee\u4F1A\u8A08 API"},hr:{schemaFile:"hr.json",baseUrl:"https://api.freee.co.jp/hr",prefix:"hr",name:"freee\u4EBA\u4E8B\u52B4\u52D9 API"},invoice:{schemaFile:"invoice.json",baseUrl:"https://api.freee.co.jp/iv",prefix:"invoice",name:"freee\u8ACB\u6C42\u66F8 API"},pm:{schemaFile:"pm.json",baseUrl:"https://api.freee.co.jp/pm",prefix:"pm",name:"freee\u5DE5\u6570\u7BA1\u7406 API"},sm:{schemaFile:"sm.json",baseUrl:"https://api.freee.co.jp/sm",prefix:"sm",name:"freee\u8CA9\u58F2 API"}},Te={};function nt(t){if(!Te[t]){let e=ne[t];Te[t]={schema:qt(e.schemaFile),baseUrl:e.baseUrl,prefix:e.prefix,name:e.name}}return Te[t]}var Pe=new Proxy({},{get(t,e){if(e in ne)return nt(e)},ownKeys(){return Object.keys(ne)},getOwnPropertyDescriptor(t,e){if(e in ne)return{enumerable:!0,configurable:!0,value:nt(e)}}});function ot(t,e,r,n){let o=n.schema.paths;if(e in o){let a=o[e];if(t in a)return{isValid:!0,message:"Valid path and method",operation:a[t],actualPath:e,apiType:r,baseUrl:n.baseUrl}}for(let a of Object.keys(o)){let i=a.replace(/\{[^}]+\}/g,"[^/]+");if(new RegExp(`^${i}$`).test(e)){let p=o[a];if(t in p)return{isValid:!0,message:"Valid path and method",operation:p[t],actualPath:e,apiType:r,baseUrl:n.baseUrl}}}return null}function at(t,e,r){let n=t.toLowerCase();if(r!==void 0){let o=Pe[r],a=ot(n,e,r,o);return a||{isValid:!1,message:`Path '${e}' not found in ${o.name} schema. Please check the path format or use freee_api_list_paths to see available endpoints.`}}for(let[o,a]of Object.entries(Pe)){let i=ot(n,e,o,a);if(i)return i}return{isValid:!1,message:`Path '${e}' not found in any freee API schema. Please check the path format or use freee_api_list_paths to see available endpoints.`}}function st(){let t=[];for(let[,e]of Object.entries(Pe)){let r=e.schema.paths,n=[];Object.entries(r).forEach(([o,a])=>{let i=Object.keys(a).filter(s=>["get","post","put","delete","patch"].includes(s)).map(s=>s.toUpperCase());i.length>0&&n.push(` ${i.join("|")} ${o}`)}),n.length>0&&t.push(`
43
57
  ## ${e.name} (${e.baseUrl})
44
- ${r.sort().join(`
58
+ ${n.sort().join(`
45
59
  `)}`)}return t.join(`
46
- `)}function St(t){return typeof t=="object"&&t!==null&&"type"in t&&t.type==="binary"}function xt(t){let e=(t.size/1024).toFixed(2);return`\u30D5\u30A1\u30A4\u30EB\u3092\u30C0\u30A6\u30F3\u30ED\u30FC\u30C9\u3057\u307E\u3057\u305F
60
+ `)}function Gt(t){let e=(t.size/1024).toFixed(2);return`\u30D5\u30A1\u30A4\u30EB\u3092\u30C0\u30A6\u30F3\u30ED\u30FC\u30C9\u3057\u307E\u3057\u305F
47
61
 
48
62
  \u4FDD\u5B58\u5834\u6240: ${t.filePath}
49
63
  MIME\u30BF\u30A4\u30D7: ${t.mimeType}
50
- \u30B5\u30A4\u30BA: ${e} KB`}var H="service: accounting/hr/invoice/pm/sm",J=c.enum(["accounting","hr","invoice","pm","sm"]).describe("\u5BFE\u8C61\u306Efreee\u30B5\u30FC\u30D3\u30B9");function V(t){return async e=>{try{let{service:n,path:r,query:o,body:a}=e,i=Ge(t,r,n);if(!i.isValid)return l(`\u30D1\u30B9\u691C\u8A3C\u30A8\u30E9\u30FC: ${i.message}
64
+ \u30B5\u30A4\u30BA: ${e} KB`}var V="service: accounting/hr/invoice/pm/sm",z=c.enum(["accounting","hr","invoice","pm","sm"]).describe("\u5BFE\u8C61\u306Efreee\u30B5\u30FC\u30D3\u30B9");function q(t){return async e=>{try{let{service:r,path:n,query:o,body:a}=e,i=at(t,n,r);if(!i.isValid)return l(`\u30D1\u30B9\u691C\u8A3C\u30A8\u30E9\u30FC: ${i.message}
51
65
 
52
- \u5229\u7528\u53EF\u80FD\u306A\u30D1\u30B9\u3092\u78BA\u8A8D\u3059\u308B\u306B\u306F freee_api_list_paths \u30C4\u30FC\u30EB\u3092\u4F7F\u7528\u3057\u3066\u304F\u3060\u3055\u3044\u3002`);let s=await L(t,i.actualPath,o,a,i.baseUrl);return St(s)?l(xt(s)):l(JSON.stringify(s,null,2))}catch(n){return l(`API\u30EA\u30AF\u30A8\u30B9\u30C8\u30A8\u30E9\u30FC: ${C(n)}`)}}}function We(t){t.tool("freee_api_get",`freee API GET\u3002${H}`,{service:J,path:c.string().describe("API\u30D1\u30B9 (\u4F8B: /api/1/deals, /invoices)"),query:c.record(c.string(),c.unknown()).optional().describe("\u30AF\u30A8\u30EA\u30D1\u30E9\u30E1\u30FC\u30BF (\u30AA\u30D7\u30B7\u30E7\u30F3)")},V("GET")),t.tool("freee_api_post",`freee API POST\u3002${H}`,{service:J,path:c.string().describe("API\u30D1\u30B9 (\u4F8B: /api/1/deals, /invoices)"),body:c.record(c.string(),c.unknown()).describe("\u30EA\u30AF\u30A8\u30B9\u30C8\u30DC\u30C7\u30A3"),query:c.record(c.string(),c.unknown()).optional().describe("\u30AF\u30A8\u30EA\u30D1\u30E9\u30E1\u30FC\u30BF (\u30AA\u30D7\u30B7\u30E7\u30F3)")},V("POST")),t.tool("freee_api_put",`freee API PUT\u3002${H}`,{service:J,path:c.string().describe("API\u30D1\u30B9 (\u4F8B: /api/1/deals/123, /invoices/123)"),body:c.record(c.string(),c.unknown()).describe("\u30EA\u30AF\u30A8\u30B9\u30C8\u30DC\u30C7\u30A3"),query:c.record(c.string(),c.unknown()).optional().describe("\u30AF\u30A8\u30EA\u30D1\u30E9\u30E1\u30FC\u30BF (\u30AA\u30D7\u30B7\u30E7\u30F3)")},V("PUT")),t.tool("freee_api_delete",`freee API DELETE\u3002${H}`,{service:J,path:c.string().describe("API\u30D1\u30B9 (\u4F8B: /api/1/deals/123)"),query:c.record(c.string(),c.unknown()).optional().describe("\u30AF\u30A8\u30EA\u30D1\u30E9\u30E1\u30FC\u30BF (\u30AA\u30D7\u30B7\u30E7\u30F3)")},V("DELETE")),t.tool("freee_api_patch",`freee API PATCH\u3002${H}`,{service:J,path:c.string().describe("API\u30D1\u30B9 (\u4F8B: /api/1/deals/123)"),body:c.record(c.string(),c.unknown()).describe("\u30EA\u30AF\u30A8\u30B9\u30C8\u30DC\u30C7\u30A3"),query:c.record(c.string(),c.unknown()).optional().describe("\u30AF\u30A8\u30EA\u30D1\u30E9\u30E1\u30FC\u30BF (\u30AA\u30D7\u30B7\u30E7\u30F3)")},V("PATCH")),t.tool("freee_api_list_paths","freee API \u30A8\u30F3\u30C9\u30DD\u30A4\u30F3\u30C8\u4E00\u89A7\u3002\u8A73\u7D30\u306A\u30AC\u30A4\u30C9\u306Ffreee-mcp skill\u3092\u53C2\u7167\u3002",{},async()=>{let e=Ke();return l(`# freee API \u5229\u7528\u53EF\u80FD\u306A\u30A8\u30F3\u30C9\u30DD\u30A4\u30F3\u30C8\u4E00\u89A7${e}
66
+ \u5229\u7528\u53EF\u80FD\u306A\u30D1\u30B9\u3092\u78BA\u8A8D\u3059\u308B\u306B\u306F freee_api_list_paths \u30C4\u30FC\u30EB\u3092\u4F7F\u7528\u3057\u3066\u304F\u3060\u3055\u3044\u3002`);let s=await U(t,i.actualPath,o,a,i.baseUrl);return Ge(s)?l(Gt(s)):l(JSON.stringify(s,null,2))}catch(r){return l(`API\u30EA\u30AF\u30A8\u30B9\u30C8\u30A8\u30E9\u30FC: ${k(r)}`)}}}function ct(t){t.tool("freee_api_get",`freee API GET\u3002${V}`,{service:z,path:c.string().describe("API\u30D1\u30B9 (\u4F8B: /api/1/deals, /invoices)"),query:c.record(c.string(),c.unknown()).optional().describe("\u30AF\u30A8\u30EA\u30D1\u30E9\u30E1\u30FC\u30BF (\u30AA\u30D7\u30B7\u30E7\u30F3)")},q("GET")),t.tool("freee_api_post",`freee API POST\u3002${V}`,{service:z,path:c.string().describe("API\u30D1\u30B9 (\u4F8B: /api/1/deals, /invoices)"),body:c.record(c.string(),c.unknown()).describe("\u30EA\u30AF\u30A8\u30B9\u30C8\u30DC\u30C7\u30A3"),query:c.record(c.string(),c.unknown()).optional().describe("\u30AF\u30A8\u30EA\u30D1\u30E9\u30E1\u30FC\u30BF (\u30AA\u30D7\u30B7\u30E7\u30F3)")},q("POST")),t.tool("freee_api_put",`freee API PUT\u3002${V}`,{service:z,path:c.string().describe("API\u30D1\u30B9 (\u4F8B: /api/1/deals/123, /invoices/123)"),body:c.record(c.string(),c.unknown()).describe("\u30EA\u30AF\u30A8\u30B9\u30C8\u30DC\u30C7\u30A3"),query:c.record(c.string(),c.unknown()).optional().describe("\u30AF\u30A8\u30EA\u30D1\u30E9\u30E1\u30FC\u30BF (\u30AA\u30D7\u30B7\u30E7\u30F3)")},q("PUT")),t.tool("freee_api_delete",`freee API DELETE\u3002${V}`,{service:z,path:c.string().describe("API\u30D1\u30B9 (\u4F8B: /api/1/deals/123)"),query:c.record(c.string(),c.unknown()).optional().describe("\u30AF\u30A8\u30EA\u30D1\u30E9\u30E1\u30FC\u30BF (\u30AA\u30D7\u30B7\u30E7\u30F3)")},q("DELETE")),t.tool("freee_api_patch",`freee API PATCH\u3002${V}`,{service:z,path:c.string().describe("API\u30D1\u30B9 (\u4F8B: /api/1/deals/123)"),body:c.record(c.string(),c.unknown()).describe("\u30EA\u30AF\u30A8\u30B9\u30C8\u30DC\u30C7\u30A3"),query:c.record(c.string(),c.unknown()).optional().describe("\u30AF\u30A8\u30EA\u30D1\u30E9\u30E1\u30FC\u30BF (\u30AA\u30D7\u30B7\u30E7\u30F3)")},q("PATCH")),t.tool("freee_api_list_paths","freee API \u30A8\u30F3\u30C9\u30DD\u30A4\u30F3\u30C8\u4E00\u89A7\u3002\u8A73\u7D30\u306A\u30AC\u30A4\u30C9\u306Ffreee-mcp skill\u3092\u53C2\u7167\u3002",{},async()=>{let e=st();return l(`# freee API \u5229\u7528\u53EF\u80FD\u306A\u30A8\u30F3\u30C9\u30DD\u30A4\u30F3\u30C8\u4E00\u89A7${e}
53
67
 
54
68
  \u4F7F\u7528\u4F8B:
55
69
  freee_api_get { "service": "accounting", "path": "/api/1/deals", "query": { "limit": 10 } }
56
70
  freee_api_get { "service": "invoice", "path": "/invoices" }
57
- freee_api_post { "service": "accounting", "path": "/api/1/deals", "body": { "issue_date": "2024-01-01", ... } }`)})}async function Xe(){let t=await fe(),e=new Rt({name:t.server.name,version:t.server.version});He(e),We(e);try{await Z(),console.error(`OAuth callback server started on http://127.0.0.1:${t.oauth.callbackPort}`)}catch(r){console.error("Failed to start callback server:",r),console.error("OAuth authentication will fall back to manual mode")}let n=new $t;await e.connect(n),console.error("Freee MCP Server running on stdio"),process.on("SIGINT",()=>{U(),process.exit(0)}),process.on("SIGTERM",()=>{U(),process.exit(0)})}import re from"prompts";import Ae from"node:crypto";import Ft from"open";I();import te from"node:fs/promises";import R from"node:path";import q from"node:os";var ne="freee-mcp",Mt={command:"npx",args:["@him0/freee-mcp"]};function Ee(t){let e=q.platform();if(t==="claude-code")return R.join(q.homedir(),".claude.json");if(e==="darwin")return R.join(q.homedir(),"Library","Application Support","Claude","claude_desktop_config.json");if(e==="win32"){let n=process.env.APPDATA||R.join(q.homedir(),"AppData","Roaming");return R.join(n,"Claude","claude_desktop_config.json")}else return R.join(q.homedir(),".config","Claude","claude_desktop_config.json")}function Qe(t){return t==="claude-code"?"Claude Code":"Claude Desktop"}async function Pe(t){try{let e=await te.readFile(t,"utf-8");return JSON.parse(e)}catch{return null}}async function Ye(t,e){let n=R.dirname(t);await te.mkdir(n,{recursive:!0}),await te.writeFile(t,JSON.stringify(e,null,2)+`
58
- `,"utf-8")}async function Ze(t){let e=Ee(t);try{await te.access(e);let n=await Pe(e);return{path:e,exists:!0,hasFreeeConfig:n?.mcpServers?.[ne]!==void 0}}catch{return{path:e,exists:!1,hasFreeeConfig:!1}}}async function et(t){let e=Ee(t),n=await Pe(e);n||(n={}),n.mcpServers||(n.mcpServers={}),n.mcpServers[ne]={...Mt},await Ye(e,n)}async function tt(t){let e=Ee(t),n=await Pe(e);n?.mcpServers?.[ne]&&(delete n.mcpServers[ne],Object.keys(n.mcpServers).length===0&&delete n.mcpServers,await Ye(e,n))}F();async function Dt(t){let e=await fetch(`${W}/api/1/companies`,{headers:{Authorization:`Bearer ${t}`,"Content-Type":"application/json"}});if(!e.ok){let r=await w(e);throw new Error(`\u4E8B\u696D\u6240\u4E00\u89A7\u306E\u53D6\u5F97\u306B\u5931\u6557\u3057\u307E\u3057\u305F: ${e.status} ${JSON.stringify(r)}`)}return(await e.json()).companies||[]}async function Ot(){let t=await Promise.resolve().then(()=>(I(),Me)).then(i=>i.loadFullConfig()),e=!!(t.clientId&&t.clientSecret);e&&(console.log("\u65E2\u5B58\u306E\u8A2D\u5B9A\u304C\u898B\u3064\u304B\u308A\u307E\u3057\u305F\u3002"),console.log(` \u5909\u66F4\u3057\u306A\u3044\u9805\u76EE\u306F\u305D\u306E\u307E\u307E Enter \u3092\u62BC\u3057\u3066\u304F\u3060\u3055\u3044\u3002
71
+ freee_api_post { "service": "accounting", "path": "/api/1/deals", "body": { "issue_date": "2024-01-01", ... } }`)})}async function lt(){let t=await de(),e=new Kt({name:t.server.name,version:t.server.version});tt(e),ct(e);let r=new Wt;await e.connect(r),console.error("Freee MCP Server running on stdio")}import ae from"prompts";import oe from"node:fs/promises";import O from"node:path";import G from"node:os";var ie="freee-mcp",Xt={command:"npx",args:["@him0/freee-mcp"]};function Se(t){let e=G.platform();if(t==="claude-code")return O.join(G.homedir(),".claude.json");if(e==="darwin")return O.join(G.homedir(),"Library","Application Support","Claude","claude_desktop_config.json");if(e==="win32"){let r=process.env.APPDATA||O.join(G.homedir(),"AppData","Roaming");return O.join(r,"Claude","claude_desktop_config.json")}else return O.join(G.homedir(),".config","Claude","claude_desktop_config.json")}function pt(t){return t==="claude-code"?"Claude Code":"Claude Desktop"}async function ve(t){try{let e=await oe.readFile(t,"utf-8");return JSON.parse(e)}catch{return null}}async function ut(t,e){let r=O.dirname(t);await oe.mkdir(r,{recursive:!0}),await oe.writeFile(t,JSON.stringify(e,null,2)+`
72
+ `,"utf-8")}async function ft(t){let e=Se(t);try{await oe.access(e);let r=await ve(e);return{path:e,exists:!0,hasFreeeConfig:r?.mcpServers?.[ie]!==void 0}}catch{return{path:e,exists:!1,hasFreeeConfig:!1}}}async function mt(t){let e=Se(t),r=await ve(e);r||(r={}),r.mcpServers||(r.mcpServers={}),r.mcpServers[ie]={...Xt},await ut(e,r)}async function dt(t){let e=Se(t),r=await ve(e);r?.mcpServers?.[ie]&&(delete r.mcpServers[ie],Object.keys(r.mcpServers).length===0&&delete r.mcpServers,await ut(e,r))}w();w();import{z as I}from"zod";var Qt=I.object({id:I.number(),name:I.string(),display_name:I.string(),role:I.string()}),gt=I.object({companies:I.array(Qt).optional()});async function ht(t){let e=await fetch(`${X}/api/1/companies`,{headers:{Authorization:`Bearer ${t}`,"Content-Type":"application/json"}});if(!e.ok){let o=await _(e),a=o.success?JSON.stringify(o.data):`(JSON parse failed: ${o.error})`;throw new Error(`\u4E8B\u696D\u6240\u4E00\u89A7\u306E\u53D6\u5F97\u306B\u5931\u6557\u3057\u307E\u3057\u305F: ${e.status} ${a}`)}let r=await e.json(),n=gt.safeParse(r);if(!n.success)throw new Error(`Invalid companies response format: ${n.error.message}`);return n.data.companies||[]}async function Ct(){let t=await Promise.resolve().then(()=>(M(),Ue)).then(i=>i.loadFullConfig()),e=!!(t.clientId&&t.clientSecret);e&&(console.log("\u65E2\u5B58\u306E\u8A2D\u5B9A\u304C\u898B\u3064\u304B\u308A\u307E\u3057\u305F\u3002"),console.log(` \u5909\u66F4\u3057\u306A\u3044\u9805\u76EE\u306F\u305D\u306E\u307E\u307E Enter \u3092\u62BC\u3057\u3066\u304F\u3060\u3055\u3044\u3002
59
73
  `)),console.log(`\u30B9\u30C6\u30C3\u30D7 1/3: OAuth\u8A8D\u8A3C\u60C5\u5831\u306E\u5165\u529B
60
- `);let n=await re([{type:"text",name:"clientId",message:"FREEE_CLIENT_ID:",initial:t.clientId||void 0,validate:i=>i.trim()?!0:"CLIENT_ID \u306F\u5FC5\u9808\u3067\u3059"},{type:"password",name:"clientSecret",message:e?"FREEE_CLIENT_SECRET (\u5909\u66F4\u3057\u306A\u3044\u5834\u5408\u306F\u7A7A\u6B04):":"FREEE_CLIENT_SECRET:",validate:i=>e&&!i.trim()||i.trim()?!0:"CLIENT_SECRET \u306F\u5FC5\u9808\u3067\u3059"},{type:"text",name:"callbackPort",message:"FREEE_CALLBACK_PORT:",initial:String(t.callbackPort||M)}]);if(!n.clientId)throw new Error("\u30BB\u30C3\u30C8\u30A2\u30C3\u30D7\u304C\u30AD\u30E3\u30F3\u30BB\u30EB\u3055\u308C\u307E\u3057\u305F\u3002");let r=n.clientId.trim(),o=n.clientSecret.trim()||t.clientSecret,a=parseInt(n.callbackPort.trim(),10);if(!o)throw new Error("CLIENT_SECRET \u306F\u5FC5\u9808\u3067\u3059\u3002");return process.env.FREEE_CLIENT_ID=r,process.env.FREEE_CLIENT_SECRET=o,process.env.FREEE_CALLBACK_PORT=String(a),console.log(`
74
+ `);let r=await ae([{type:"text",name:"clientId",message:"FREEE_CLIENT_ID:",initial:t.clientId||void 0,validate:i=>i.trim()?!0:"CLIENT_ID \u306F\u5FC5\u9808\u3067\u3059"},{type:"password",name:"clientSecret",message:e?"FREEE_CLIENT_SECRET (\u5909\u66F4\u3057\u306A\u3044\u5834\u5408\u306F\u7A7A\u6B04):":"FREEE_CLIENT_SECRET:",validate:i=>e&&!i.trim()||i.trim()?!0:"CLIENT_SECRET \u306F\u5FC5\u9808\u3067\u3059"},{type:"text",name:"callbackPort",message:"FREEE_CALLBACK_PORT:",initial:String(t.callbackPort||j)}]);if(!r.clientId)throw new Error("\u30BB\u30C3\u30C8\u30A2\u30C3\u30D7\u304C\u30AD\u30E3\u30F3\u30BB\u30EB\u3055\u308C\u307E\u3057\u305F\u3002");let n=r.clientId.trim(),o=r.clientSecret.trim()||t.clientSecret,a=parseInt(r.callbackPort.trim(),10);if(!o)throw new Error("CLIENT_SECRET \u306F\u5FC5\u9808\u3067\u3059\u3002");return process.env.FREEE_CLIENT_ID=n,process.env.FREEE_CLIENT_SECRET=o,process.env.FREEE_CALLBACK_PORT=String(a),console.log(`
61
75
  \u8A8D\u8A3C\u60C5\u5831\u3092\u53D7\u3051\u53D6\u308A\u307E\u3057\u305F\u3002
62
- `),{clientId:r,clientSecret:o,callbackPort:a}}async function jt(){console.log(`\u30B9\u30C6\u30C3\u30D7 2/3: OAuth\u8A8D\u8A3C
63
- `),console.log("\u30D6\u30E9\u30A6\u30B6\u3067\u8A8D\u8A3C\u30DA\u30FC\u30B8\u3092\u958B\u304D\u307E\u3059..."),await Promise.resolve().then(()=>(k(),Fe)).then(i=>i.loadConfig()),await Z();let t=Ae.randomBytes(32).toString("base64url"),e=Ae.createHash("sha256").update(t).digest("base64url"),n=Ae.randomBytes(16).toString("base64url"),r=Q(e,n,j());console.log(`
64
- \u8A8D\u8A3CURL: ${r}
65
- `),await Ft(r),console.log("\u30D6\u30E9\u30A6\u30B6\u3067\u8A8D\u8A3C\u3092\u5B8C\u4E86\u3057\u3066\u304F\u3060\u3055\u3044..."),console.log(`\u8A8D\u8A3C\u304C\u5B8C\u4E86\u3059\u308B\u3068\u81EA\u52D5\u7684\u306B\u6B21\u306E\u30B9\u30C6\u30C3\u30D7\u306B\u9032\u307F\u307E\u3059\u3002
66
- `);let o=Be(),a=new Promise((i,s)=>{let p=setTimeout(()=>{s(new Error("\u8A8D\u8A3C\u304C\u30BF\u30A4\u30E0\u30A2\u30A6\u30C8\u3057\u307E\u3057\u305F\uFF085\u5206\uFF09"))},G);o.registerCliAuthHandler(n,{resolve:m=>{clearTimeout(p),i(m)},reject:m=>{clearTimeout(p),s(m)},codeVerifier:t})});try{let i=await a;console.log("\u8A8D\u8A3C\u30B3\u30FC\u30C9\u3092\u53D7\u3051\u53D6\u308A\u307E\u3057\u305F\u3002"),console.log("\u30C8\u30FC\u30AF\u30F3\u3092\u53D6\u5F97\u4E2D...");let s=await Y(i,t,j());return console.log(`\u30C8\u30FC\u30AF\u30F3\u3092\u53D6\u5F97\u3057\u307E\u3057\u305F\u3002
67
- `),{accessToken:s.access_token,refreshToken:s.refresh_token}}finally{o.removeCliAuthHandler(n)}}async function Ut(t){console.log(`\u30B9\u30C6\u30C3\u30D7 3/3: \u30C7\u30D5\u30A9\u30EB\u30C8\u4E8B\u696D\u6240\u306E\u9078\u629E
68
- `),console.log("\u4E8B\u696D\u6240\u4E00\u89A7\u3092\u53D6\u5F97\u4E2D...");let e=await Dt(t);if(e.length===0)throw new Error("\u5229\u7528\u53EF\u80FD\u306A\u4E8B\u696D\u6240\u304C\u3042\u308A\u307E\u305B\u3093\u3002");let n=await re({type:"select",name:"companyId",message:"\u30C7\u30D5\u30A9\u30EB\u30C8\u306E\u4E8B\u696D\u6240\u3092\u9078\u629E\u3057\u3066\u304F\u3060\u3055\u3044:",choices:e.map(o=>({title:`${o.display_name||o.name} (ID: ${o.id}) - ${o.role}`,value:o.id}))});if(!n.companyId)throw new Error("\u30BB\u30C3\u30C8\u30A2\u30C3\u30D7\u304C\u30AD\u30E3\u30F3\u30BB\u30EB\u3055\u308C\u307E\u3057\u305F\u3002");let r=e.find(o=>o.id===n.companyId);if(!r)throw new Error(`\u9078\u629E\u3057\u305F\u4E8B\u696D\u6240\u304C\u898B\u3064\u304B\u308A\u307E\u305B\u3093: ID ${n.companyId}`);return console.log(`
69
- ${r.display_name||r.name} \u3092\u9078\u629E\u3057\u307E\u3057\u305F\u3002
70
- `),{selected:{id:r.id,name:r.name,displayName:r.display_name||r.name,role:r.role},all:e}}async function Lt(t,e,n){let r={clientId:t.clientId,clientSecret:t.clientSecret,callbackPort:t.callbackPort,defaultCompanyId:String(e.id),currentCompanyId:String(e.id),companies:{}};n.forEach(o=>{r.companies[String(o.id)]={id:String(o.id),name:o.display_name||o.name,description:`Role: ${o.role}`,addedAt:Date.now(),lastUsed:o.id===e.id?Date.now():void 0}}),await T(r),console.log(`\u8A2D\u5B9A\u60C5\u5831\u3092\u4FDD\u5B58\u3057\u307E\u3057\u305F\u3002
71
- `),console.log("\u8A8D\u8A3C\u60C5\u5831\u306F ~/.config/freee-mcp/config.json \u306B\u4FDD\u5B58\u3055\u308C\u307E\u3057\u305F\u3002"),console.log(`\u30C8\u30FC\u30AF\u30F3\u306F ~/.config/freee-mcp/tokens.json \u306B\u4FDD\u5B58\u3055\u308C\u307E\u3057\u305F\u3002
72
- `)}async function nt(t){let e=Qe(t),n=await Ze(t);if(n.hasFreeeConfig){let{action:r}=await re({type:"select",name:"action",message:`${e} \u306B freee-mcp \u304C\u8A2D\u5B9A\u6E08\u307F\u3067\u3059\u3002\u3069\u3046\u3057\u307E\u3059\u304B?`,choices:[{title:"\u305D\u306E\u307E\u307E (\u5909\u66F4\u306A\u3057)",value:"keep"},{title:"\u524A\u9664\u3059\u308B",value:"remove"}],initial:0});r==="remove"?(await tt(t),console.log(` \u2713 ${e} \u304B\u3089 freee-mcp \u3092\u524A\u9664\u3057\u307E\u3057\u305F\u3002`)):console.log(` - ${e} \u306E\u8A2D\u5B9A\u306F\u5909\u66F4\u3057\u307E\u305B\u3093\u3002`)}else{let{shouldAdd:r}=await re({type:"confirm",name:"shouldAdd",message:`${e} \u306B freee-mcp \u3092\u8FFD\u52A0\u3057\u307E\u3059\u304B?`,initial:!0});r?(await et(t),console.log(` \u2713 ${e} \u306B freee-mcp \u3092\u8FFD\u52A0\u3057\u307E\u3057\u305F\u3002`),console.log(` \u8A2D\u5B9A\u30D5\u30A1\u30A4\u30EB: ${n.path}`)):console.log(` - ${e} \u3078\u306E\u8FFD\u52A0\u3092\u30B9\u30AD\u30C3\u30D7\u3057\u307E\u3057\u305F\u3002`)}}async function Nt(){console.log(`=== MCP\u8A2D\u5B9A ===
76
+ `),{clientId:n,clientSecret:o,callbackPort:a}}async function wt(t){console.log(`\u30B9\u30C6\u30C3\u30D7 3/3: \u30C7\u30D5\u30A9\u30EB\u30C8\u4E8B\u696D\u6240\u306E\u9078\u629E
77
+ `),console.log("\u4E8B\u696D\u6240\u4E00\u89A7\u3092\u53D6\u5F97\u4E2D...");let e=await ht(t);if(e.length===0)throw new Error("\u5229\u7528\u53EF\u80FD\u306A\u4E8B\u696D\u6240\u304C\u3042\u308A\u307E\u305B\u3093\u3002");let r=await ae({type:"select",name:"companyId",message:"\u30C7\u30D5\u30A9\u30EB\u30C8\u306E\u4E8B\u696D\u6240\u3092\u9078\u629E\u3057\u3066\u304F\u3060\u3055\u3044:",choices:e.map(o=>({title:`${o.display_name||o.name} (ID: ${o.id}) - ${o.role}`,value:o.id}))});if(!r.companyId)throw new Error("\u30BB\u30C3\u30C8\u30A2\u30C3\u30D7\u304C\u30AD\u30E3\u30F3\u30BB\u30EB\u3055\u308C\u307E\u3057\u305F\u3002");let n=e.find(o=>o.id===r.companyId);if(!n)throw new Error(`\u9078\u629E\u3057\u305F\u4E8B\u696D\u6240\u304C\u898B\u3064\u304B\u308A\u307E\u305B\u3093: ID ${r.companyId}`);return console.log(`
78
+ ${n.display_name||n.name} \u3092\u9078\u629E\u3057\u307E\u3057\u305F\u3002
79
+ `),{selected:{id:n.id,name:n.name,displayName:n.display_name||n.name,role:n.role},all:e}}async function yt(t){let e=pt(t),r=await ft(t);if(r.hasFreeeConfig){let{action:n}=await ae({type:"select",name:"action",message:`${e} \u306B freee-mcp \u304C\u8A2D\u5B9A\u6E08\u307F\u3067\u3059\u3002\u3069\u3046\u3057\u307E\u3059\u304B?`,choices:[{title:"\u305D\u306E\u307E\u307E (\u5909\u66F4\u306A\u3057)",value:"keep"},{title:"\u524A\u9664\u3059\u308B",value:"remove"}],initial:0});n==="remove"?(await dt(t),console.log(` \u2713 ${e} \u304B\u3089 freee-mcp \u3092\u524A\u9664\u3057\u307E\u3057\u305F\u3002`)):console.log(` - ${e} \u306E\u8A2D\u5B9A\u306F\u5909\u66F4\u3057\u307E\u305B\u3093\u3002`)}else{let{shouldAdd:n}=await ae({type:"confirm",name:"shouldAdd",message:`${e} \u306B freee-mcp \u3092\u8FFD\u52A0\u3057\u307E\u3059\u304B?`,initial:!0});n?(await mt(t),console.log(` \u2713 ${e} \u306B freee-mcp \u3092\u8FFD\u52A0\u3057\u307E\u3057\u305F\u3002`),console.log(` \u8A2D\u5B9A\u30D5\u30A1\u30A4\u30EB: ${r.path}`)):console.log(` - ${e} \u3078\u306E\u8FFD\u52A0\u3092\u30B9\u30AD\u30C3\u30D7\u3057\u307E\u3057\u305F\u3002`)}}async function _t(){console.log(`=== MCP\u8A2D\u5B9A ===
73
80
  `),console.log(`Claude Code / Claude Desktop \u306B freee-mcp \u3092\u8A2D\u5B9A\u3067\u304D\u307E\u3059\u3002
74
- `),await nt("claude-code"),console.log(""),await nt("claude-desktop"),console.log(""),console.log("\u30BB\u30C3\u30C8\u30A2\u30C3\u30D7\u5B8C\u4E86!"),console.log(`\u5909\u66F4\u3092\u53CD\u6620\u3059\u308B\u306B\u306F\u3001Claude Code / Claude Desktop \u3092\u518D\u8D77\u52D5\u3057\u3066\u304F\u3060\u3055\u3044\u3002
75
- `)}async function rt(){console.log(`
81
+ `),await yt("claude-code"),console.log(""),await yt("claude-desktop"),console.log(""),console.log("\u30BB\u30C3\u30C8\u30A2\u30C3\u30D7\u5B8C\u4E86!"),console.log(`\u5909\u66F4\u3092\u53CD\u6620\u3059\u308B\u306B\u306F\u3001Claude Code / Claude Desktop \u3092\u518D\u8D77\u52D5\u3057\u3066\u304F\u3060\u3055\u3044\u3002
82
+ `)}import be from"node:crypto";import Yt from"open";w();async function kt(){console.log(`\u30B9\u30C6\u30C3\u30D7 2/3: OAuth\u8A8D\u8A3C
83
+ `),console.log("\u30D6\u30E9\u30A6\u30B6\u3067\u8A8D\u8A3C\u30DA\u30FC\u30B8\u3092\u958B\u304D\u307E\u3059..."),await Promise.resolve().then(()=>(T(),Le)).then(i=>i.loadConfig()),await Xe();let t=be.randomBytes(32).toString("base64url"),e=be.createHash("sha256").update(t).digest("base64url"),r=be.randomBytes(16).toString("base64url"),n=te(e,r,J());console.log(`
84
+ \u8A8D\u8A3CURL: ${n}
85
+ `),await Yt(n),console.log("\u30D6\u30E9\u30A6\u30B6\u3067\u8A8D\u8A3C\u3092\u5B8C\u4E86\u3057\u3066\u304F\u3060\u3055\u3044..."),console.log(`\u8A8D\u8A3C\u304C\u5B8C\u4E86\u3059\u308B\u3068\u81EA\u52D5\u7684\u306B\u6B21\u306E\u30B9\u30C6\u30C3\u30D7\u306B\u9032\u307F\u307E\u3059\u3002
86
+ `);let o=et(),a=new Promise((i,s)=>{let p=setTimeout(()=>{s(new Error("\u8A8D\u8A3C\u304C\u30BF\u30A4\u30E0\u30A2\u30A6\u30C8\u3057\u307E\u3057\u305F\uFF085\u5206\uFF09"))},R);o.registerCliAuthHandler(r,{resolve:u=>{clearTimeout(p),i(u)},reject:u=>{clearTimeout(p),s(u)},codeVerifier:t})});try{let i=await a;console.log("\u8A8D\u8A3C\u30B3\u30FC\u30C9\u3092\u53D7\u3051\u53D6\u308A\u307E\u3057\u305F\u3002"),console.log("\u30C8\u30FC\u30AF\u30F3\u3092\u53D6\u5F97\u4E2D...");let s=await re(i,t,J());return console.log(`\u30C8\u30FC\u30AF\u30F3\u3092\u53D6\u5F97\u3057\u307E\u3057\u305F\u3002
87
+ `),{accessToken:s.access_token,refreshToken:s.refresh_token}}finally{o.removeCliAuthHandler(r)}}M();async function Et(t,e,r){let n={clientId:t.clientId,clientSecret:t.clientSecret,callbackPort:t.callbackPort,defaultCompanyId:String(e.id),currentCompanyId:String(e.id),companies:{}};r.forEach(o=>{n.companies[String(o.id)]={id:String(o.id),name:o.display_name||o.name,description:`Role: ${o.role}`,addedAt:Date.now(),lastUsed:o.id===e.id?Date.now():void 0}}),await $(n),console.log(`\u8A2D\u5B9A\u60C5\u5831\u3092\u4FDD\u5B58\u3057\u307E\u3057\u305F\u3002
88
+ `),console.log("\u8A8D\u8A3C\u60C5\u5831\u306F ~/.config/freee-mcp/config.json \u306B\u4FDD\u5B58\u3055\u308C\u307E\u3057\u305F\u3002"),console.log(`\u30C8\u30FC\u30AF\u30F3\u306F ~/.config/freee-mcp/tokens.json \u306B\u4FDD\u5B58\u3055\u308C\u307E\u3057\u305F\u3002
89
+ `)}async function Ie(){console.log(`
76
90
  === freee-mcp Configuration Setup ===
77
91
  `),console.log("\u3053\u306E\u30A6\u30A3\u30B6\u30FC\u30C9\u3067\u306F\u3001freee-mcp\u306E\u8A2D\u5B9A\u3068\u8A8D\u8A3C\u3092\u5BFE\u8A71\u5F0F\u3067\u884C\u3044\u307E\u3059\u3002"),console.log(`freee OAuth\u8A8D\u8A3C\u60C5\u5831\u304C\u5FC5\u8981\u3067\u3059\u3002
78
- `);try{let t=await Ot(),e=await jt(),{selected:n,all:r}=await Ut(e.accessToken);await Lt(t,n,r),await Nt()}catch(t){t instanceof Error?console.error(`
92
+ `);try{let t=await Ct(),e=await kt(),{selected:r,all:n}=await wt(e.accessToken);await Et(t,r,n),await _t()}catch(t){t instanceof Error?console.error(`
79
93
  Error: ${t.message}`):console.error(`
80
- \u8A2D\u5B9A\u4E2D\u306B\u30A8\u30E9\u30FC\u304C\u767A\u751F\u3057\u307E\u3057\u305F:`,t),process.exit(1)}finally{U()}}var Bt=async()=>{let e=process.argv.slice(2)[0];if(e==="configure"){await rt();return}e&&e!=="client"&&(console.error(`Unknown subcommand: ${e}`),console.error("Usage: freee-mcp [configure]"),console.error(" configure - Interactive configuration setup"),process.exit(1)),console.error("Starting freee MCP server"),await Xe()};Bt().catch(t=>{console.error("Fatal error:",t),process.exit(1)});
94
+ \u8A2D\u5B9A\u4E2D\u306B\u30A8\u30E9\u30FC\u304C\u767A\u751F\u3057\u307E\u3057\u305F:`,t),process.exit(1)}finally{Ze()}}var Zt=async()=>{let e=process.argv.slice(2)[0];if(e==="configure"){await Ie();return}e&&e!=="client"&&(console.error(`Unknown subcommand: ${e}`),console.error("Usage: freee-mcp [configure]"),console.error(" configure - Interactive configuration setup"),process.exit(1)),console.error("Starting freee MCP server"),await lt()};Zt().catch(t=>{console.error("Fatal error:",t),process.exit(1)});
package/package.json CHANGED
@@ -1,8 +1,7 @@
1
1
  {
2
2
  "type": "module",
3
3
  "name": "@him0/freee-mcp",
4
- "version": "0.6.1",
5
- "main": "dist/index.js",
4
+ "version": "0.6.3",
6
5
  "bin": {
7
6
  "freee-mcp": "./bin/cli.js"
8
7
  },
@@ -10,23 +9,10 @@
10
9
  "license": "ISC",
11
10
  "description": "Model Context Protocol (MCP) server for freee API integration",
12
11
  "devDependencies": {
13
- "@changesets/cli": "^2.29.8",
14
12
  "@modelcontextprotocol/inspector": "^0.17.2",
15
- "@types/node": "^24.10.1",
16
- "@types/prompts": "^2.4.9",
17
- "@typescript-eslint/eslint-plugin": "^8.48.1",
18
- "@typescript-eslint/parser": "^8.48.1",
19
13
  "@vitest/coverage-v8": "^3.2.4",
20
14
  "@vitest/ui": "^3.2.4",
21
- "esbuild": "^0.25.12",
22
- "eslint": "^9.39.1",
23
- "eslint-config-prettier": "^10.1.8",
24
- "jsdom": "^26.1.0",
25
15
  "knip": "^5.78.0",
26
- "prettier": "^3.7.4",
27
- "tsx": "^4.21.0",
28
- "typescript": "^5.9.3",
29
- "vitest": "^3.2.4",
30
16
  "yaml": "^2.8.2"
31
17
  },
32
18
  "dependencies": {
@@ -45,7 +31,8 @@
45
31
  ],
46
32
  "repository": {
47
33
  "type": "git",
48
- "url": "https://github.com/him0/freee-mcp.git"
34
+ "url": "https://github.com/him0/freee-mcp.git",
35
+ "directory": "packages/freee-mcp"
49
36
  },
50
37
  "files": [
51
38
  "dist/",
@@ -53,9 +40,7 @@
53
40
  "README.md"
54
41
  ],
55
42
  "scripts": {
56
- "build": "pnpm run build:types && pnpm run build:esbuild",
57
- "build:esbuild": "tsx build.ts",
58
- "build:types": "tsc --declaration --emitDeclarationOnly --declarationDir './dist'",
43
+ "build": "tsx build.ts",
59
44
  "start": "tsx src/index.ts",
60
45
  "dev": "tsx watch src/index.ts",
61
46
  "typecheck": "tsc --noEmit",
@@ -69,9 +54,6 @@
69
54
  "test:coverage": "vitest run --coverage",
70
55
  "test:ui": "vitest --ui",
71
56
  "generate:references": "tsx scripts/generate-references.ts",
72
- "fetch:schemas": "tsx scripts/fetch-schemas.ts",
73
- "changeset": "changeset",
74
- "version": "changeset version",
75
- "release": "pnpm build && changeset publish"
57
+ "fetch:schemas": "tsx scripts/fetch-schemas.ts"
76
58
  }
77
59
  }
package/README.md DELETED
@@ -1,207 +0,0 @@
1
- # @him0/freee-mcp
2
-
3
- freee API を Claude から使えるようにする MCP サーバー & Claude Plugin です。
4
-
5
- MCP サーバー(API 呼び出し機能)と skill(API リファレンス)を組み合わせて利用することを想定しています。
6
-
7
- [![npm version](https://badge.fury.io/js/@him0%2Ffreee-mcp.svg)](https://www.npmjs.com/package/@him0/freee-mcp)
8
-
9
- > Note: このプロジェクトは開発中であり、予期せぬ不具合が発生する可能性があります。問題を発見された場合は [Issue](https://github.com/him0/freee-mcp/issues) として報告していただけると幸いです。プルリクエストも歓迎しています。
10
-
11
- ## 特徴
12
-
13
- - MCP サーバー: freee API を Claude Desktop / Claude Code から直接呼び出し
14
- - Claude Plugin: 詳細な API リファレンスドキュメント付きスキルを提供
15
- - 複数 API 対応: 会計・人事労務・請求書・工数管理・販売の5つの freee API をサポート
16
- - OAuth 2.0 + PKCE: セキュアな認証フロー、トークン自動更新
17
- - 複数事業所対応: 事業所の動的切り替えが可能
18
-
19
- ## SKILL と MCP の通信の流れ
20
-
21
- Claude Code では、SKILL(API リファレンス)と MCP サーバー(API 呼び出し)を組み合わせて利用します。
22
-
23
- ```mermaid
24
- sequenceDiagram
25
- participant User as ユーザー
26
- participant Claude as Claude Code
27
- participant Skill as Agent Skill<br/>(API リファレンス)
28
- participant MCP as MCP サーバー<br/>(ローカル)
29
- participant API as freee API
30
-
31
- User->>Claude: リクエスト<br/>「取引一覧を取得して」
32
-
33
- Note over Claude,Skill: 1. SKILL からリファレンスを取得
34
- Claude->>Skill: freee-api-skill 呼び出し
35
- Skill-->>Claude: API リファレンス注入<br/>(エンドポイント、パラメータ仕様)
36
-
37
- Note over Claude,MCP: 2. MCP Tool で API を実行
38
- Claude->>MCP: freee_api_get 呼び出し<br/>path: /api/1/deals
39
- MCP->>MCP: OpenAPI スキーマで検証
40
- MCP->>MCP: 認証トークン付与
41
-
42
- Note over MCP,API: 3. freee API への通信
43
- MCP->>API: GET /api/1/deals<br/>Authorization: Bearer xxx
44
- API-->>MCP: JSON レスポンス
45
-
46
- MCP-->>Claude: 取引データ
47
- Claude-->>User: 結果を整形して表示
48
- ```
49
-
50
- この仕組みにより:
51
- - SKILL: 必要な API リファレンスを段階的にコンテキストに注入(コンテキスト効率化)
52
- - MCP: 認証・リクエスト検証・API 呼び出しを担当
53
-
54
- ## クイックスタート
55
-
56
- ### 1. freee アプリケーションの登録
57
-
58
- [freee アプリストア](https://app.secure.freee.co.jp/developers) で新しいアプリを作成:
59
-
60
- - コールバックURL: `http://127.0.0.1:54321/callback`
61
- - Client ID と Client Secret を取得
62
- - 必要な権限にチェック
63
-
64
- ### 2. セットアップ
65
-
66
- ```bash
67
- npx @him0/freee-mcp configure
68
- ```
69
-
70
- 対話式ウィザードが認証情報の設定、OAuth認証、事業所選択を行います。
71
-
72
- ### 3. Claude Desktop に追加
73
-
74
- `configure` が出力する設定を Claude Desktop の設定ファイルに追加:
75
-
76
- | OS | 設定ファイルパス |
77
- | ------- | ----------------------------------------------------------------- |
78
- | macOS | `~/Library/Application Support/Claude/claude_desktop_config.json` |
79
- | Windows | `%APPDATA%\Claude\claude_desktop_config.json` |
80
- | Linux | `~/.config/Claude/claude_desktop_config.json` |
81
-
82
- ```json
83
- {
84
- "mcpServers": {
85
- "freee": {
86
- "command": "npx",
87
- "args": ["@him0/freee-mcp"]
88
- }
89
- }
90
- }
91
- ```
92
-
93
- > ⚠️ 環境変数での設定について
94
- > 環境変数(`FREEE_CLIENT_ID`、`FREEE_CLIENT_SECRET` など)を使った設定は非推奨です。
95
- > 代わりに `npx @him0/freee-mcp configure` を実行して設定ファイルに移行してください。
96
- > 環境変数設定は将来のバージョンで削除される予定です。
97
-
98
- ## Claude Plugin として使う
99
-
100
- Claude Code でプラグインとしてインストールすると、API リファレンス付きのスキルが利用できます:
101
-
102
- ```bash
103
- claude plugin marketplace add him0/freee-mcp
104
- claude plugin install freee-api
105
- ```
106
-
107
- ### 含まれるリファレンス
108
-
109
- | API | 内容 | ファイル数 |
110
- | -------- | -------------------------------------------- | ---------- |
111
- | 会計 | 取引、勘定科目、取引先、請求書、経費申請など | 31 |
112
- | 人事労務 | 従業員、勤怠、給与明細、年末調整など | 27 |
113
- | 請求書 | 請求書、見積書、納品書 | 3 |
114
- | 工数管理 | ユーザー情報 | 1 |
115
- | 販売 | 案件、受注 | 2 |
116
-
117
- Claude との会話中に API の使い方を質問すると、これらのリファレンスを参照して正確な情報を提供します。
118
-
119
- ### データ作成のベストプラクティス
120
-
121
- 請求書や経費精算など、同じ形式のデータを繰り返し作成する場合は、以前に作成したデータを参照することで効率的に作業できます:
122
-
123
- - 請求書作成: 過去の請求書を取得して、取引先・品目・税区分などを参考にする
124
- - 経費精算: 過去の申請を参照して、勘定科目や部門の指定を正確に行う
125
- - 取引登録: 類似の取引を参考にして、入力ミスを防ぐ
126
-
127
- ```
128
- 例: 「先月の○○社への請求書を参考に、今月分を作成して」
129
- ```
130
-
131
- ## 利用可能なツール
132
-
133
- ### 管理ツール
134
-
135
- | ツール | 説明 |
136
- | -------------------------- | ------------------ |
137
- | `freee_authenticate` | OAuth 認証を実行 |
138
- | `freee_auth_status` | 認証状態を確認 |
139
- | `freee_clear_auth` | 認証情報をクリア |
140
- | `freee_set_current_company`| 事業所を切り替え |
141
- | `freee_get_current_company`| 現在の事業所を表示 |
142
- | `freee_list_companies` | 事業所一覧を取得 |
143
- | `freee_current_user` | 現在のユーザー情報 |
144
-
145
- ### API ツール
146
-
147
- HTTPメソッドごとのシンプルなツール構成:
148
-
149
- | ツール | 説明 | 例 |
150
- | ---------------------- | ------------------ | ------------------ |
151
- | `freee_api_get` | データ取得 | `/api/1/deals` |
152
- | `freee_api_post` | 新規作成 | `/api/1/deals` |
153
- | `freee_api_put` | 更新 | `/api/1/deals/123` |
154
- | `freee_api_delete` | 削除 | `/api/1/deals/123` |
155
- | `freee_api_patch` | 部分更新 | `/api/1/deals/123` |
156
- | `freee_api_list_paths` | エンドポイント一覧 | - |
157
-
158
- パスは OpenAPI スキーマに対して自動検証されます。
159
-
160
- ### company_id の取り扱い
161
-
162
- リクエスト(パラメータまたはボディ)に `company_id` を含める場合、現在の事業所と一致している必要があります。不一致の場合はエラーになります。
163
-
164
- - 事業所の確認: `freee_get_current_company`
165
- - 事業所の切り替え: `freee_set_company`
166
- - company_id を含まない API(例: `/api/1/companies`)はそのまま実行可能
167
-
168
- ## 開発者向け
169
-
170
- ```bash
171
- git clone https://github.com/him0/freee-mcp.git
172
- cd freee-mcp
173
- pnpm install
174
-
175
- pnpm dev # 開発サーバー(ウォッチモード)
176
- pnpm build # ビルド
177
- pnpm typecheck # 型チェック
178
- pnpm lint # リント
179
- pnpm test:run # テスト
180
-
181
- # API リファレンスの再生成
182
- pnpm generate:references
183
- ```
184
-
185
- ### 技術スタック
186
-
187
- TypeScript / Model Context Protocol SDK / OAuth 2.0 + PKCE / Zod / esbuild
188
-
189
- ### アーキテクチャ詳細
190
-
191
- プロジェクトのアーキテクチャ、内部構造、開発ガイドラインについては [CLAUDE.md](./CLAUDE.md) を参照してください。
192
-
193
- ## ライセンス
194
-
195
- ISC
196
-
197
- ## コミュニティ
198
-
199
- 質問や情報交換は Discord サーバーで行っています。お気軽にご参加ください。
200
-
201
- - [Discord サーバー](https://discord.gg/fPA75nHp)
202
-
203
- ## 関連リンク
204
-
205
- - [紹介記事: Public API を MCP化するとき Agent Skill 併用が良さそう with freee-mcp](https://zenn.dev/him0/articles/766798ca1315e0)
206
- - [freee API ドキュメント](https://developer.freee.co.jp/docs)
207
- - [Model Context Protocol](https://modelcontextprotocol.io)
package/dist/.keep DELETED
File without changes